l 


The official Raspberry Pi magazine 


Issue 121 | September 2022 | magpi.cc 


Fe’ GLOBAL 
ay DELIVERY 
magpi.cc/store | [Press 


z 

=I 
ae 
ay 
ren 
CO 
= 

2 


BUILD A & @F 
RASPBERRY PI 
RADIO 


YOUR OWN 
VIRTUAL PET 


54 PAGES UF PRUJELIS & TUTORIALS 


UL) uisten Industrial Raspberry PI 


&* @ BES TL 4) 2357 


Proagramminc 
ogramming 


@ 
@ 
TW so 
oe 
= 


e 


A> 
Sd 
ny 
a 
1] 


Preferences 


ilePi 


The ComfilePi is a touch panel PC designed with high-tolerant components and no moving 
parts for industrial applications. It features a water-resistant front panel, touchscreen, 
color LCD (available in various sizes), RS-232, RS-485, Ethernet, USB, I2C, SPI, digital 1O, 

battery-backed RTC (real-time clock), and piezo buzzer. 


Use the rear-panel 40-pin GPIO header to expand its features and capabilities with additional 
I/O boards. The ComfilePi is UL Listed and employs Raspberry Pi Compute Module. 


CCCCOCECOCC CYC EE) 


seeessesese mS 
CP-1022-A4-2 
COMPILE 


[ ial 
Seececoeoeoe 


oO © 


COMFILE 


Visit www.comfiletech.com © copyright COMFILE Technology, Inc. ALL RIGHTS RESERVED TECHNOLOGY 


WELCOME 
to The MagP1 121 


lectricity is fantastic stuff! It’s used to power 
labour-saving gizmos, light up our streets, move 


our cars, and perform everyday miracles that would 


seem the stuff of magic to our ancestors. 

Understanding electronics is half of the code and digital- 
making ethos that underpins Raspberry Pi. And few 
devices are better for learning electronics than Pico W. 
Designed to sit right at the heart of electronic projects, 
Pico is a low-power microcontroller development board 
with 40 connections on the side — you can connect Pico to 
just about anything. 

Learning electronics is a rite of passage for new 
Raspberry Pi aficionados. Start by lighting up lights, then 
create code that responds to buttons, wire up sensors, 
pull in information from the internet, and build wild 
creations (page 30). 

Getting an understanding of code and electronics is 
an incredibly important skill to have. With it, you can 
control, and understand, all 
the incredible things around = aspuenny 1 MAGAZINE 
you that make the modern \ your he 8 
world work. 


Lucy Hattersley Editor 
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Lucy 
Hattersley 


Lucy is editor 

of The MagPi 
magazine and is 
currently sitting 

in the Greenwich 
Maritime Museum 
wondering how they 
made do with sails. 
There are some 
seriously impressive 
figureheads on 

the wall beside 

her though. 


@LucyHattersley 
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Looking for the latest products? Look no further. With over 
400,000 new products stocked, we've got your electronic 
component and automation needs covered. 


Find it at digikey.co.uk/new or call 0800 587 0991. 


Digi-Key is a franchised distributor for all supplier partners. New products added daily. Digi-Key and Digi-Key Electronics are registered trademarks of Digi-Key Electronics in the U.S. and 
other countries. © 2022 Digi-Key Electronics, 701 Brooks Ave. South, Thief River Falls, MN 56701, USA 
D> ECIA MEMBER 


@ Supporting The Authorized Channel 


ME Magri | PROJECT SHOWCASE 


ZeroBug 


An inexpensive 3D-printable hexapod that can be programmed or 


directly controlled. Rob Zwetsloot checks its micro servos 


intimidating SpiderPi, a big hexapod robot 
that tormented our editor’s poor cat. Shortly 
after the release of the issue, Maximilian Kern 
emailed us about the one he’d created himself, 
called ZeroBug, appropriately powered bya 
Raspberry Pi Zero. 
“Zero is in charge of the input methods,” 


[ n issue 119 (magpi.cc/119), we reviewed the 


mee Maximilian explains. “It runs a custom web 
interface and an instance of Pygame. This 
makes it possible to control the robot using a 
A hardware 


mouse, keyboard, multitouch, or simply an Xbox 
gamepad... Instead of specialised robotics servos, 
this robot uses inexpensive micro servos. Inside 
its 3D-printed frame there is just enough room for 
Raspberry Pi, together with a custom PCB for the 
microcontroller and servo driver.” 
The microcontroller is an STM32, which is 
an ARM-based system which controls the leg 
locomotion through 18 of the affordable servos. 
“All of these calculations run at 50Hz, 
enabling the hexapod to move smoothly and with 
high precision.” 


developer based in 
Germany, who likes 
to do DIY projects 
in his spare time, 
including hardware, 
software and 
mechanical design. 


magpi.cc/zerobug 


aes Six degrees 
Msi Maximilian was inspired by earlier 
videos of the Boston Dynamics robot 
experiments, and loved 
the idea of making 
robots with legs 
— starting with 
a quadrupedal 
creation of his 
own, before 
moving to six legs. 
“Tt turned 
out to be really 
difficult to develop 
proper walking gaits, 
and the servos seemed to 
struggle with the weight of 


A The simulations Me 
involved wire-frame if 


models of ZeroBug 
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the robot,” he tells us. “The decision to go with 
four legs instead of six was mainly due to the cost 
of servo motors. However, six-legged robots have 
a big advantage: unlike quadrupeds, they can lift 
three of their legs while the remaining legs form a 
stable tripod. This eliminates the need for constant 
weight shifting and balancing.” 

The decision to use Raspberry Pi was due to how 
easily you can connect Bluetooth controllers to it, 
making it more accessible than RC controllers. With 
this in mind, Maximilian started simulating his robot. 

“With the simulation done, I went on to build 
the physical hexapod robot,” he says. “Since 
there are 18 servos needed for this hexapod, they 
define the total cost of the robot. I settled for some 
cheap Emax ESo8A I] micro servos which are quite 
powerful for their size. I only paid around €80 
for the entire set of servos. When using proper 
smart servos for robotics, a single unit can cost 
this much.” 

To drive the servos, 18 PWM outputs are 
needed. “I decided to use the STM32F103 as a 
microcontroller as it is Arduino-compatible, and 
I had already gathered some experience with my 
macro keyboard (magpi.cc/macrokeypad). To 
connect the microcontroller, PWM driver, and 
Raspberry Pi, I designed a custom PCB that plugs 
into the back of the GPIO header on Raspberry 
Pi. To save space, the connector only uses GPIO 
1 though 10, which conveniently include 5V, 
3.3V, ground, UART, and a couple extra I/O. 
Voltage regulators on the custom PCB enable the 
microcontroller and Raspberry Pi to be powered 
from the battery pack. Both Zero W and the custom 
board are mounted between the servos, so that the 
USB port can be accessed from the outside.” 


Scuttling along 

Maximilian claims that building a walking robot is 
not that hard; instead, making it look right while 
walking can be a challenge. 


PROJECT SHOWCASE | Mdg?i 


Getting the right walk 
cycle is tricky - it can 
easily look unnatural 


NiMH batteries are used 4g 


over lithium alternatives . Qui ck FACTS 
as they offer more power bi) 


—~ iy — & > There's already a 
: Raspberry Pi-only 
version of the robot 


> The simulator was 
built in Processing... 


> wand was 
used to add 
complexity until it 
moved properly 


With the camera and 
mandible, it can pick stuff 


up and move it around 


> It's also inspired by 
Matt Denton's uBug 
(magpi.cc/ubug)... 


> ..and even the 
custom 3D-printed 
parts are based on 
that design 


M Six-legged robots have 
g big advantage: unlike 
guadrupeds they can lift 
three of their legs while 
the remaining legs form a 
Stable tripod @ 
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“Overall, 1am really happy with how this project 
turned out,” Maximilian tells us. “I actually started 
working on a simulator in 2014 and shelved the 
whole project out of frustration, only to digit upa 
few years later. Just at the start of last year it really 
clicked, and I got the motivation to go through 
with it.” 

You can read a lot more about his development 
process on his Hackaday page (magpi.cc/zerobug), 
and he also has some ideas on how to improve it 


5 A Raspberry Pi Zero W is used in the first iteration 
in the future. Z 


for controllers, but can controlthe whole robot & 
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Big Mouth Billy Bass 


An attention-seeking interactive fish gets a Pico W update 
and becomes an online star, discovers Rosie Hattersley 


n the early 2000s, Big Mouth Billy Bass - a a Pico W-controlled update to the tuneful 
[ kitschy, 3D plastic fish mounted in a picture animatronic sea creature, hosted at mouthpi.co. 
frame that appears to sing, as well as writhe Kevin first fell in love with computing when he 
around — became such an in-demand item that became the proud owner of a ZX Spectrum back 
there’s reputedly one hanging proudly above the in 1982. He went on to study computer science. 
grand piano at the Queen’s Balmoral residence. He had a similarly Damascene encounter when 
YouTuber, and Raspberry Pi enthusiast, Kevin he got his first Raspberry Pi not long after it first 
Kevin McAleer relates this apocryphal tale while launched. “Raspberry Pi has helped me learn and 
McAleer introducing his latest Raspberry Pi project: master Linux and inspired me to learn Python, 


Kevin McAleer 
makes robots, 
brings them to life 
with code, and 
makes videos about 
them on YouTube. 


magpi.cc/ 
kevinmcaleer 


ere © Live streaming - YouTube Sts KW http yftwitter comrecanttayy x eiry ans. x + » 


€ X OQ — & mouthpicomheadout or ODGQeoeenuG: 


Big Mouth Billy Bass 


This website is hosted on a Raspberry Pi Pico W, in the Robotlab, hotgiued inside a Big Mouth Billy Bass. You can remotely control Big 
Mouth Billy by clicking the buttons below. 


Catch the YouTube video about this project by clicking here. 


f f Move Head Out | Mov Heodin | Open Mouth || Closed Mouth || Move Tail Out I Move Tail in 
P The site being = \ 


constructed during 


Kevin's weekly Screen Share www.smarsfa 
YouTube broadcast 
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The animatronic fish 
used to play Don’t 


Worry, Be Happy, 
while flapping his fins 


Quick FACTS 


> Catch Billy Bass in 
action to see the 
full effect 


> Kev contemplated 
livestreaming 
footage of Billy 
writhing around 


Visitors to mouthpi.co 
choose whether Billy 
should open or close his 


Kev used — 4 month, move blsiheadwor > The current version 
Raspberry Pi Pico | a tail, with audio buttons goes through 

W to make Billy soon to be added QV batteries 

Bass controllable ; *very® quickly 


from a web page 

> So Kev will switch 
to mains power fish 
frolics soon 


> Rob interviewed 
Kevin for The MagPi 
in issue #118 


which is now my go-to language for all projects.” 
Every Sunday, Kevin hosts a YouTube series 
(head to magpi.cc/kevinmcaleer) discussing all 


M Raspberry Pi has helped me 
learn and master Linux @ 


things Raspberry Pi, and is also an accomplished 
robot builder. 


Big Mouth strikes again 

When Pico W launched in June, Kevin was keen to 
put the wireless-enabled microcontroller through 
its paces. Several Pico W web-page-control 
projects appeared online, but Kevin felt they 

didn’t show the new product’s full abilities. He’d 
previously bought a Big Mouth Billy Bass from eBay 
for around £20, and reasoned pairing it with Pico W ‘ 
might help him “stretch its capabilities beyond : a 

common expectations. 7 A Kevin wanted to show that a Pico W-powered web page could be more than plain text 
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A Asachild of the 
1980s, Kevin couldn't 
resist designing 
a Raspberry Pi- 
based Ghostbusters 
wireless scanner 


He wanted to see how well it would hold up with 
thousands of web page requests per day, and to 
see how well the web pages could handle colour, 
fonts, and style sheets. “Pico W doesn’t have an OS 
and has minimal memory, so being able to host a 
website and control a robot simultaneously is quite 
remarkable,” says Kevin. The mouthpi.co site 
is hosted on the Pico W, which is in turn hidden 
within the fish robot’s body. 

Kevin contemplated livestreaming footage of 
Billy writhing around, but the current iteration 
of the site has buttons that the user can press to 
initiate preset movements relating to the head, 
tail, and mouth. A replacement for the audio files 
containing the original Big Mouth Billy Bass theme 
tunes — Don’t Worry Be Happy and Take Me To The 
River — is planned for the next version. Kevin has 
also promised his YouTube followers a Furby-based 
Pico W-controlled site. 


Hacking the hardware 

One of the key aspects of this project was 
establishing how the existing animatronic 
fish worked. Online research revealed some 
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A The WiFi scanner spreads its arms to show signal strength 


details, usually with a view to controlling the fish 
with Alexa, whereas Kevin’s plan was to control 
the motors himself. However, a tear-down of Billy 
Bass’s components, in which Kevin stripped out 
the existing wiring, showed a relatively simple 
circuit with three motors. 

Having learnt these were “cheap 5 V DC motors”, 
Kevin was confident he’d be able to drive them 
with a couple of L298N H-bridge modules. He 
secured them along with Pico W on a mounting 
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Big Mouth Billy Bass 


This website is hosted on a Raspberry Pi Pico W, in the Robotlab, hotglued inside @ Big Mouth Billy Bass, You can remotely contro 
Big Mouth Billy by clicking the buttons below, 


Catch the YouTube video about this project by clicking nere 


4 A . 


Source a Billy Bass or a similar robot. 
Disassemble it to see what's inside and 
sketch out the proposed schematic. Here, H-bridges 
are used to drive the robot's three motors. 


plate to hold them in place. These would allow A When website visitors click 

; : F button to change Billy’ 
him to control powerful motors simply by making Boe ine leven ono: 
a GPIO pin on the Pico high or low (1 or 0). Code is shown 


shared by Raspberry Pi’s Alasdair Allan for making 
an LED light up came in useful here, as did the 


Kevin used Pico W and MicroPython to set 
up a ‘billy’ class, so moving the head and 

tail and opening and closing the mouth requires 
simple commands such as ‘billy.open_mouth’ or 
‘billy.flap_tail(3)’ to flap the tail three times. 


lM Kevin was confident he'd be 
able to drive them with a couple 
of L298N H-bridge modules @ 


realisation that, as well as sharing the 9 V battery 
between the motors, the battery ground needed to 
be connected to the Pico W too. 

The entire setup cost approximately £20, 
with a further £20 for the domain name and 
Cloudflare-hosted website (which offers DDoS 
protection) covering the next five years. Full 
MicroPython code and setup instructions are 
at magpi.cc/bigmouthwifi. 

Meanwhile, Kevin is already well on his way 
to his next Pico W project: a Ghostbusters PKE 
WiFi scanner that moves its arms to indicate the 
strength of the available wireless connection. Hl 


Prior to reassembling the Billy Bass case, Kevin 
used a Pimoroni Pico Explorer to test the wiring. 
The top white motor moved the head, as expected, 
while the others made the tail flap. 


Big Mouth Billy Bass | magpi.cc | 13 


ME Magri | PROJECT SHOWCASE 


Digital 
Zoetrope 


Brian Corteil has created a fresh spin on an age-old 
idea and it's made David Crookes dizzy with excitement 


Brian Corteil 


Brian is a maker 
and amateur robot 
designer with a 
“toy age" of eight. 
He's a member 

of Cambridge 
Makespace. 


@CannonFodder 


Warning! 
Moving parts 


Be careful with objects 
that spin at high speeds 
and do not touch them 


oetropes were invented bya 
Z mathematician called William Horner in 

1834 and they proved to be an effective way 
to produce animations. A set of still images would 
line the inside of a rotating drum, and viewers 
would peer through narrow Slits in the side. The 
speed at which they passed the eyes would produce 
an illusion of movement. As the years went by, the 
technique was refined and zoetropes remain as 
much fun today as they did nearly 190 years ago. 

As if to prove the concept still has legs, Brian 

Corteil has created his own version. “I’ve found 
zoetropes and optical illusions fascinating since 
I was a child,” he tells us, having worked on his 
latest one for a recent EMF Camp in the hope 
of inspiring children at STEM/STEAM events. 
“They're perfect for showing how persistent 
vision works and I love playing with old and new 
technology, combining them into an art project.” 


Spinning around 
Brian’s previous attempt made use of twelve OLED 
displays, each displaying a different still from 
Eadweard Muybridge’s photographic studies of 
a galloping horse taken in 1878. “I’ve used his 
images on several occasions for my projects,” he 
says. “If you reduce the number of pixels, even to 
a 16x16 LED matrix, you can still see the details 
of a rider on a horse. They’ re ideally suited for 
displaying on a zoetrope.” 
His first digital zoetrope was not interactive, 
however, and it needed to be spun by hand. 
“The OLED displays also required a custom PCB 
designed to be linked together as a distributed shift 
register,” he says. But although the displays could 
be updated via a connected Raspberry Pi computer, 
the results weren’t perfect. “When the zoetrope 
was spun, a dark diagonal line was visible as the 
OLED displays were being refreshed.” 
The answer, he surmised, was e-ink displays. 
“They overcame the issue by not needing to 
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The zoetrope has a 
slip-ring in the middle 
of the Lazy Susan 
bearing. It maintains a 
power connection when 
spinning by using a 
brush or wiper in contact 
with a rotating ring 


be refreshed to continue displaying a static 
image,” he adds. “I also liked how e-ink displays 
mirrored the look of paper.” For these, Brian 
used 15 Pimoroni Badger 2040s — fast updating, 
programmable badges with e-ink displays that 
utilise the RP2040 microcontroller. He also used 
a Raspberry Pi Pico board to control the motor 
that spins the zoetrope. It monitors the safety 
emergency stop buttons too. 


Getting animated 

Brian designed the zoetrope using the CAD 
program SolidWorks, creating outlines to be 
laser-cut from 3mm and 5mm plywood. Parts that 
couldn’t be made this way were 3D-printed, and 
the device was made large enough to accommodate 
the Badgers and their USB leads. “Some of the 
challenges involved making the zoetrope light 
enough to be able to move,” Brian says. “It also 
needed to be carried by one person, and robust 
enough to avoid being damaged by the public.” 

To control the entire device, Brian employed a 
Raspberry Pi 4 computer, using it to send screen 
updates over the USB connections. Another 
Raspberry Pi 4 is connected to a flatbed scanner 
and it allows animations created on a cell sheet 
to be scanned and uploaded to the zoetrope. 
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A total of 15 Pimoroni Badger 
2040s have been used. Each 
2.9-inch e-ink display has a 

resolution of 296 x 128 pixels 


> This huge build 
Brian has designed the zoetrope uses e-ink displays 
to be as easy to operate as 
possible, and it includes a big 
red emergency stop button, laser-cutting 
controlled by Raspberry Pi Pico plywood 


It also involves 


¥ 


Vv 


It requires 
Raspberry Pi Pico 
and Raspberry 

Pi 4 devices 


Vv 


\ New images 
‘ 9 
can be created 


and uploaded 


bee TT 


¥ 


The project cost 
Brian about £1300 


™ Some of the challenges 
involved making the 
zoetrope light enough to 
be able to move @ 


———— 


This means kids can get creative at events — 
or else press a touchscreen monitor and see 
past animations! 
“The zoetrope has gone down a storm with 
children, and I’d like to thank Pimoroni for 
supplying me with 20 Badgers, Phil Howard, 
S 
t 


oftware developer at Pimoroni, for creating 
he custom firmware that enables images to be 


uploaded, and Brian Starkey for his help pasting 
together my code and knocking out a web user A The zoetrope - the innards of 
i : : which are shown here - has 
interface. This project would not have been been to EMF Camp and Liverpool re a 
possible without the support of the EMF art Maker est al owing Kide o(cteats 
animations and see them come 


installation fund either.” alive in front of their eyes 
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Fireballs Aotearoa 


A chance to expand meteor monitoring to New Zealand was made 
far simpler with the aid of Raspberry Pi. Rosie Hattersley reports 


Dr James Scott, 
Jeremy Taylor, 
Jim Rowe 


Dr James Scott, 

a geologist at 

he University of 
Otago, and Jeremy 
Taylor set up the 
Fireballs Aotoreoa 
meteor tracking 
programme with 
input from Jim 
Rowe of the UK 
Fireball Alliance. 


fireballs.nz 


(fireballs.nz) is an ambitious research 

project that aims to make good on the 
Global Meteor Network’s aim of ensuring no 
meteor is undetected. The GMN’s worldwide 
meteor and meteorite tracking endeavours already 
had sites spread across Europe and the US, but few 
in the Southern Hemisphere. With international 
news coverage of a fireball over southern England 
in March 2021 that was successfully tracked by 
citizen scientists, there has been a significant 
increase in the number of meteor cameras 


T he excitingly named Fireballs Aotearoa 


4 The meteor camera network will monitor the 
skies over the whole of New Zealand 
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in the UK and beyond. A Fireballs Aotearoa 
outreach programme involving New Zealand- 
based astronomers and meteor researchers 
generated much excitement among would-be 
space scientists. 

This online presentation given by Jim Rowe 
(magpi.cc/findingmeteorites) explains howa 
camera attached to a Raspberry Pi locks on toa 
fireball as it travels across the sky, focusing on 
the object itself and only processing data relating 
to its constantly changing location. Raspberry 
Pi has sufficient processing bandwidth to live- 
track and report the meteor’s location. Since 
multiple cameras across a region track the same 
meteor’s journey, it’s possible to triangulate its 
final destination and work out with some accuracy 
where it must have landed, and potentially 
recover it, for further study, explains Jim. 


™ Raspberry Pi and Sony 
camera lenses have become 
the de facto hardware @ 


New horizons 

Raspberry Pi and Sony camera lenses have 
become the de facto hardware, lowering the 
cost of setting up a meteor camera to less than 
£200. Expanding coverage in Scotland and New 
Zealand is important for Jim Rowe of the UK 
Fireball Alliance. Jim was incredibly excited 


Fireballs Aotearoa meteor 
cameras use Sony IMX291 
image sensors to record 720p 
footage of meteor showers and 
other wonders in the night sky 


A Raspberry Pi 4 or 3B+ 
controls each setup, identifies 
the meteor within a frame, and 
saves only this part of each 
25fps image to its SD card 
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Once the data is processed, 
Raspberry Pi uploads each 
set of data to a server at the 
University of Western Ontario 


Tea ok Aas A 
Quick FACTS 
| 


| > The New Zealand 

| cameras capture 
meteors that would 
otherwise be 
missed... 


> ..since most such 
cameras cover 
the northern 
hemisphere 


» Access to the 
meteor camera 
data by schools 
is critical 


> By involving them 
in planetary study, 
it's hoped... 


> ..rural Otago 
students might be 


inspired to become 
astronomers 
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The project is already 
detecting plenty of 
meteor activity in the 
southern hemisphere, 
as this open-source 
meteor map reveals 


UK Fireball Alliance's 
James Rowe's talk on 
meteor tracking showed 
how Raspberry Pi- 
powered cameras helped 
triangulate locations 


RMS NZOO@2_ _ 03-05-2022 


when Dr James Scott of the University of Otago 
succeeded in getting funding for the first ten 
meteor camera kits for use in New Zealand, and 
helped acquire 20 more Raspberry Pi computers 
for meteor tracking and university use with a 
grant from the MBIE Curious Minds Participatory 
Science Platform. A key part of the funding pitch 
is the direct link with schools and their access to 
the project data. James says the goal is to record 
meteors on every clear night — a single camera 
in Invercargill picked up 114 meteorites crossing 
the sky one evening in early March - with 
students able to log in at any time to see what has 


South Wales — 11/12 May 


Data from FRIPON and 
Desert Fireball Network, 
trajectory by Dr Hadrien 

Devillepoix, Curtin 
University WA 
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2022 


Bigger strewn field 
because of light cloud — 
press release but no 
search 


Fireballs Aotearoa 


\ 


Detected metears: OOOL10 


crossed ‘their’ night sky and incorporate that in 
their schoolwork. 

“Rather than simply recording pictures of 
meteors, the idea is to collect science-grade 
data that can inform researchers, capturing 
information about meteor orbits, frequency, flux, 
mass indices, source regions, and so on. This can 
be used to refine prediction models and help us 
learn more about parts of the solar system nearest 
to us. All the high-level data products from the 
GMN project are publicly released under CC BY 
4.0 and updated every six hours so researchers 
can have access to near-real-time information, 
explains Jeremy Taylor (aka Tasmanskies) who 
has been “a driving force” behind the meteor 
camera builds. 


” 


Searching for a sky fall 

Only nine meteorites have been discovered 

in New Zealand, and only the 1908 Mokoia 
meteorite in Tauranga was seen to fall. With the 
country having a land-mass larger than the UK, 
Dr Scott aims “to discover the next meteorite 


| 
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Winchcombe as seen by the five 
different UK fireball camera systems 


— 


Build a meteor camera 


Global Meteor Network (credit 
Paul Dickinson) 


P 


UFOCapture (credit Richard Fleet, 


UKMON) AllSky7 (credit Ben Stanley) 
a A egg 


You will need a Raspberry Pi 3B+ or 4, HQ or 
equivalent camera, and a waterproof housing. 
Follow Jeremy's setup instructions provided at 
magpi.cc/assemblingGMS. Start by unscrewing 

the lens to remove the infrared filter, and cut off the 
camera mount nubbins so it sits flush. 


UK Fireball Network 


(Desert Fireball ) 
s SCAMP (FRIPON) - 


bal 


that comes into New Zealand through a citizen- 4 Multiple sailors saad 
ae - are cross-reference ie} 

led initiative.” The meteor cameras are put aid the recover of 

together by students from the rocketry club at falling meteors 


the University of Otago and installed at locations 
around New Zealand, creating the densest 
southern hemisphere meteor-tracking network. 
The network is already capturing plenty of 
activity. “Raspberry Pi is essential for calculating 
the meteor trajectory each camera picks up and 
determining the ‘strewn’ field where debris 
should have landed,” says James. 


Attach a heatsink and run a power supply 
to Raspberry Pi, since you will need it to be 
running constantly if you want the best chance of 
capturing meteor footage. 


™ Raspberry Pi is very easy to program and 
operate. We easily link to the boards at 
the schools vid Gg remote connection H P ‘a 


“Raspberry Pi is awesome; small enough to sit 
around unobtrusively, but powerful enough to 
control a night-sky camera and manipulate the 
data that it collects, such as generating stacked 
images of the duration of the night,” enthuses 
James. “Raspberry Pi is very easy to program 
and operate. We easily link to the boards at the 
schools via a remote connection, which enables 
us to see the live stream, edit images, and access 
photos and videos. These are easily recompiled 
into time-lapses. It’s just brilliant.” 

As a future development, Jeremy Taylor hopes 
it will be possible to install meteor cameras in 
Antarctica — with Raspberry Pi inside, of course! 


Connect everything together and place it 
inside a waterproof casing. Install somewhere 
there's a clear sky view, as with this Fireballs 
Aotearoa meteor camera at a school site in Otago, 
New Zealand. 
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LEGO Reaction Wheel 
Inverted Pendulum 


Tackling a classic problem of control system dynamics with 


LEGO and Raspberry Pi. Phil King takes a balanced view 


A ARaspberry Pi Zero 


Juha 


“A Finnish middle- 
aged guy,” Juha 
runs the Brick 
Experiment Channel 
on YouTube, 
dedicated to 
building and 
experimenting 
with LEGO Technic 
bricks. He has 
worked for over 
ten years asa 
software engineer. 


magpi.cc/ 
becyoutube 


2 W runs the Python 
code that takes the 
sensor readings 
and controls the 
motor accordingly 


a popular challenge in control theory 

- which deals with the behaviour of 
dynamical systems - and requires precise motion 
control to prevent it from falling over. It’s 
something maker and YouTuber Juha, of the Brick 
Experiment Channel, learned about in courses he 
did 20 years ago, which inspired him to try it with 
LEGO and Raspberry Pi. 

Made of LEGO bricks, his inverted pendulum 
requires active control to stay upright. A ‘reaction 
wheel’, also made from LEGO, is mounted on the 
pendulum and attached to a motor controlled by 
a Raspberry Pi Zero 2 W. “Rotating the wheel will 
generate torque on the pendulum and thereby 
change the pendulum angle,” he explains. “The 
rest is just measurement and computation.” 

Well, that’s the theory, but in practice it’s 
not quite so easy and, as shown in his YouTube 
video (magpi.cc/legopendulum), Juha had 
to alter his Python code repeatedly and make 
hardware adjustments to get the system to work to 
his satisfaction. 


KK eeping an inverted pendulum aloft is 
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Precision control 

A gyroscope and accelerometer on a mini IMU 
(inertia measurement unit) board are used to 
measure the pendulum angle, while Raspberry Pi 
runs a control loop for filtering data and calculating 
PID (proportional-integral-derivative) controller 
outputs for adjusting the motor’s speed and 
direction. Automatically calculating corrections 
based on feedback, PID is one of the most common 
control methods used in industrial and mechanical 
applications, such as in a car’s cruise control 
system. It’s also fairly easy to implement. 

“Others have used LQR [linear-quadratic 
regulator] control for inverted pendulums,” notes 
Juha, “but it looks too mathematical and difficult 
for me. As for tuning the PID parameters, I didn’t 
have any approach other than ‘try and see.’ It got 
good laughs in the YouTube comment section as it 
looks so unprofessional.” 

While Juha opted to use a Raspberry Pi Zero 2 W 
for its fast bootup speed, “CPU load was only 5% 
running the control loop with aims interval, so it 
would work with a much less capable board.” He 
even tried using a Pico, which “worked OK in terms 
of processing power, but then I realised I need to 
store tens of megabytes of log data for drawing nice 
graphs for the video.” 

Amazingly, before this project, Juha had never 
used a Raspberry Pi before and had minimal 
experience with electronics. “I had to figure out 
how GPIO works, what are pull-down and pull-up 
resistors, how I2C works, etc.” 


Keeping it up 

The next major challenge was getting the 
pendulum to stay upright for more than two 
seconds. “The problem was with the reaction wheel 
top speed limitation,” says Juha. “There is a short 
time window for acceleration before the limit is 
reached, so you need to get past the top equilibrium 
point before that. A plain PID controller would just 


™M Rotating the wheel 
will generate torgue 
on the pendulum and 
thereby change the 
pendulum angle @ 


minimise angle error and keep the wheel rotating 
ast. I read many studies of different inverted 
pendulums, until 1 found one paper that mentioned 
tinuously changing the target angle for the PID 
troller. That solved it finally.” 

So, in the finished system, is it impossible to 

push the pendulum off balance so that it falls over? 
, hot at all,” replies Juha. “It will easily fall 
over if you push it. The controller will immediately 
to compensate for the push by accelerating 
wheel, but it can correct only for small errors. 

h a more powerful motor, higher top speed, and 
higher rotational inertia for the wheel, it would 
resist stronger pushes.” 


too f. 


con 
con 


try 


Wi 


= 


“No 


the 
t 


A Raspberry Pi Zero 
2 W runs Python 


code featuring a 
PID control loop 
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The LEGO reaction 


wheel spins at 

the precise speed 
required to keep the 
pendulum vertical 


steppes 


» The project took 
Juha two months to 
build and perfect 


Vv 


He says “it was 
painful to get 
it working" 


Vv 


His Python 

, controller code 
Connected to Raspberry Pi,a (ae é oN was rewritten 
motor controller board drives several times 
the reaction wheel motor i 


Vv 


The final program 
can be found 

at magpi.cc/ 
pendulumcode 


He has also built 

a Raspberry Pi 
LEGO submarine: 
magpi.cc/legosub 


Vv 


A An IMU board attached to the base of the 
pendulum continually measures its angle 
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Boost-Box 0.1 


The antithesis of doom-scrolling, the Boost-Box 
could be just the thing to cheer you up. Nicola King 
discovers the joy of just watching happy things! 


Martin 
Spendiff 
& Vanessa 
Bradley 


Martin is a 
mathematical 
modeller who 
left the UK for 
Switzerland, and 
a fan of FOSS and 
tech that serves 
users, rather than 
the people who 
made it. Vanessa 
is new to coding 
and a constant 
source of weird and 
good ideas. 


veeb.ch 


e just can’t get enough of Martin 
W Spendiff and Vanessa Bradley’s 

makes - last month the Pico Railway 
Clock and, this time, we present the Boost-Box. 
The productive pair have upcycled an old 1970s 
Hanimex analogue film viewer and turned it into a 
YouTube viewing terminal — but they only use it to 
watch uplifting cheerfulness! 

Martin came across the film viewer in a second 

hand store and began to feel nostalgic. “When 
I first went to uni a million years ago, we used 
terminals to do most of our work,” he recalls. “That 
aesthetic is imprinted on my brain. I saw it and 
thought ‘I need to do something with that’... but I 
wasn’t really sure what I was going to do with it.” 
After applying some thought, he realised that it 
made sense to update it, but make its use related 
to its original purpose. “I liked the idea of it going 
from being able to show the contents of a single 
roll of film, to everything YouTube has on it. What 
is it, a billion videos or so?” 


Ins and outs 

So the duo set to work on what turned out to bea 
relatively straightforward build, and the first job 
was to substitute the original screen with an LCD 
replacement. “The main annoyance,” says Martin, 
“was getting the screen I found with the right 
aspect ratio to fit into the frame. Luckily, I have 
watched plenty of videos of very patient people 
using metal files to shape things, so I settled down 
for an hour and made the aperture the right shape.” 
Next, they added a Raspberry Pi 4 and an 
ortholinear keyboard (with non-staggered keys). 
There are very few internal components in the 
original body of the viewer, as it’s mainly empty 
space. The few parts that were moved to make 
space for a small speaker have been placed into 

a small bag inside the machine; this means the 
terminal could, should they so choose, be quickly 
turned back into a Super 8 viewer. 
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The project’s Raspberry Pi 4 runs the 
Manjaro Linux operating system, while ytfzf 
(magpi.cc/ytfzf) is used as the command-line 
viewer tool. “The great thing about open source 
is that there is a huge array of tools that clever 
people have already built, so if you can ‘glue’ them 
together, you can build things quickly,” enthuses 
Martin. “It’s a pretty capable desktop machine. 
There are other command-line interface (CLI) 
tools that I’ve played with in the past (or use now) 
that would fit. NeoMutt (email) and gcalcli (Google 
Calendar) are two that spring to mind.” 


Practically perfect 

The short YouTube video that Martin and 
Vanessa created to accompany this build is 
really worth a watch (magpi.cc/boostbox), as 
you’ ll see Boost-Box’s spirit-lifting capabilities 
in action. Friends of the pair have given their 
feedback, and they seem to enjoy the retro 
look of the piece as much as anything, as 
Martin shares: “ ‘I love it, what is it°’ is the 
common response, followed closely by, ‘What 
is that keyboard*’” 


oS 
PROJEC 


YMPIc¢. ” 


A 1970s Hanimex E300 
Super 8 film viewer is used 
as the case fora vintage look |7 


The screen was 
replaced witha 
modern LCD to 
play videos 


tv The Hanimex case 


cost around £25... 
we 
While the screen 


An ortholinear keyboard is Bost about nde 


connected to a Raspberry 


Pi 4 inside the case ELCEOUTE Benner 


it to bigger 
speakers using 
7 Bluetooth 

> ) Martin has used an 
LED light power 
converter.. 


which powers 
Raspberry Pi and 
the screen 


Martin describes the make as “not a hard 
project” and, as for future improvements to the 
Boost-Box... well, maybe it doesn’t really need 


I'm avoiding doing more 
on it, as | like the idea of it 
just doing one thing 


as I like the idea of it just doing one thing,” says 
Martin. “There are a few minor tweaks that I might 
make, but for now it’s just sitting there playing 
‘Guinea Pig Olympics’ every time the world gets a 
bit too much for me.” 

Frankly, who doesn’t crave a shot of high-octane 
joyfulness a regular basis — perhaps we all need These vintage film editors can be purchased relatively 
to make our own Boost-Box? fl cheaply if you want to replicate the build 


any. “For now, I’m avoiding doing more on it, : 
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LED 


Sphere 


Tom Verbeure has brightened up our day with his stunning 
sphere peppered with LEDs, as David Crookes discovers 


Tom Verbeure 


Tom is a hardware 
engineer for 

Nvidia, who loves 
playing and 
occasionally blogs 
about all kinds of 
electronics projects. 


magpi.cc/ 
tomverbeure 


PA sphere element 
containing 21 LEDs. 
“You need to insert 
the LED through 
the sphere element, 
then try to fit each of 
its four metal leads 
through a very tiny 
0.85mm diameter 
hole,” Tom explains 
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here are many practical applications for a 
T Raspberry Pi Pico microcontroller board, 

but it’s important to have a heap of fun 
too! With his latest project, Tom Verbeure has 
literally had a ball, creating a NeoPixel-covered 
sphere that dazzles in more ways than one. 
After all, as Tom says: “LED cubes have been 
pretty popular, but spheres are a much harder 
problem, mechanically.” 

The idea for the project followed a friendly chat. 
“T was having a lunchtime discussion at work with 
my friend, Jens, a 3D printing wizard, about doing 
things with LEDs that hasn’t really been done 
before,” Tom recalls. After ordering a 3D printer 
- “and wanting to use it for something more 
than printing out an Iron Man helmet or a vase” 
— he put a plan into action. “One of my biggest 
requirements from the start was a lot of LEDs.” 


Bouncing ideas 
By the time he got started, other makers were 
creating something similar. Jifi Praus unveiled his 


Freeform LED Sphere (“but it’s constructed out of 
differently sized rings around a central axis, which 
I didn’t want”) and Whity created the Geodesic(k) 
RGB LED Spheres (“but 180 LEDs, and the LED 
density was too low because he used premade 
WS2812B PCBs”). 

With research, he learned that it’s 
mathematically impossible to distribute points 
uniformly across a sphere, but there were 
techniques which came close. “I loosened 
the requirement of uniform LED distribution 
somewhat and chose an icosahedron as the 
core internal structure,” he says. “Its 20 axes of 
symmetry is sufficiently high. 

“T also came to the conclusion that through- 
hole LEDs were the way to go if you want the 
surface of the sphere to be truly curved. You can 
adjust the length from the LED core to the PCB 
for each LED individually.” He then spent more 
than a month using FreeCAD to come up with 
potential design ideas, starting with a central 
lattice made out of hollow triangles on which 20 
PCBs and 20 triangular sphere elements were 
mounted separately. 


On aroll 
Printing and assembly issues caused a rethink. 
“The breakthrough came when I dropped the 
central frame, inserted LEDs from the outside into 
the shell, and mounted the PCBs firmly against 
the inside shell triangle,” Tom explains. “I used 
magnets on each triangle side to form a self- 
supported structure. The more sphere elements 
snap together, the sturdier it becomes.” 

Eventually, he switched from FreeCAD’s GUI to 
its embedded Python engine. He also settled on 21 
LEDs for each of the 20 sphere elements, designing 
a custom controller PCB on which to mount them. 
A Raspberry Pi Pico formed the project’s heart and 
Tom initially coded the project using MicroPython, 
later transitioning to regular C. 

“T needed something that was small, didn’t 
require a lot of power, had a lot of performance, 
was Close to the metal, had the ability to drive 


MéigPi 


The controller board contains a 
dual 18650 battery holder, a power 
regulator module, Raspberry Pi 


Pico, ESP8266, and an MPU 6050 
inertial/gyroscope sensor (for 
orientation aware light effects) 


Although an ESP8266 
wireless networking 
microchip was used, 
Raspberry Pi Pico W 


means this 


isn't 


necessary any more 


<< 


a 


Custom triangle PCBs are 
connected to each of the 
sphere sections. Each supports 
21 LEDs and it contains 21 


Surface Mo 
resistors an 


unted Device (SMD) 
d capacitors 


| used magnets on each 
triangle side to form a 


Sself-s 


upported structure 


WS2812 LEDs, and had very good documentation 
and examples,” Tom notes. “The Raspberry Pico 
scored high on all those points.” 


The result 
apart of asp 
sphere, with 


is impressive. “The LEDs are not just 
here element, but part of the whole 
a unique (x,y,z) coordinate assigned to 


it,” Tom says. It’s also battery-operated, making it 
entirely mobile. 

Tom has enjoyed the process so much, he’s on 
a roll, continuing to make improvements. “Right 


now, I’m dea 
loose wires,” 
probably use 


ing with a fair bit of instability due to 
he says. “If I were to do this again, I'd 
JST connectors instead of plain vanilla 


pin headers and connectors, because they make a 
very reliable link.” 


Tom said working with magnets was a pain during construction 
“If you make one polarity mistake while supergluing them, it 
can be impossible to remove them later" 


The 20 sphere 
elements contain 
420 LEDs overall 


Assembling the 
sphere elements 
took 20 hours 


The project 
uses 400 tiny 
neodymium 
magnets 


The magnets 
and Li-ion 18650 
batteries make 

it weighty 


Tom spent 
about $350 on 
the materials 
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Brompton 


Demand for Brompton's famous folding bicycles has soared. 
Raspberry Pi has helped the company meet challenging production 
targets at its London manufacturing facility. By Rosie Hattersley 


rompton folding bicycles are a British 
B urban icon. Invented, designed, and 

manufactured in London, their popularity 
has grown at pace, and in recent years annual 
sales have topped £100 million as Brompton has 
become the go-to solution for commuters seeking 
a smooth and swift end-to-end trip. “We’ve tried 
to make people aware that there’s a product that 
might make their life a bit happier, give them a 
bit more freedom,” says CEO Will Butler-Adams. 
Brompton’s factory systems have evolved to 
support the demands of increasing volume and 
an expanded product range, and Butler-Adams 
describes their Raspberry Pi-powered factory setup 
as slicker than any other he has seen. 


THE CHALLENGE 
Brompton first introduced Raspberry Pi in 2013 on, 
what was then, a line of nine production stations. 


The computers — the original Raspberry Pi1 Model 
B — were used to track which models were built 

at which station and when. The following year, 
Brompton expanded capacity to 16 stations in 
order to meet rising demand, but this still wasn’t 
enough: they needed to up production further, all 
while continuing to track units at every station, 
and introducing further monitoring to help meet 
increasingly demanding targets. “The only way to 
do that,” concluded senior software engineer Kane 
Tracey, “was Raspberry Pi.” 


THE SOLUTION 

Tracey says that there are over 100 Raspberry Pi 
computers inside Brompton’s factory, deployed 

in solutions ranging from pre-assembly-line and 
production-line monitoring to air quality control 
and more. A number of models are in use, including 
Raspberry Pi 4 and earlier boards. 


Raspberry Pi boards on production stations 
scan the serial number of each bicycle, tracking 
it as it progresses through the assembly process. 
The computers use the scan data to monitor and 
support production in multiple ways: for example, 
staff are provided with unit-specific instructions 
via connected displays, a laser-etching machine 
automatically produces the correct plate design for 
the type of bike under assembly, and LED indicators 


M Raspberry Pi plays a 
crucial role in Brompton's 
assembly processes @ 


help staff to meet time targets. In addition to scan 
data, production-line Raspberry Pi boards capture 
data from torque controllers, from user input, and 
more. Key performance indicators are shown on 
display screens for ease of monitoring. 

“We have this philosophy here at Brompton now 
that if we need to capture data anywhere on the 
factory floor, we throw a Raspberry Pi at it,” says 
Kane Tracey. 


WHY RASPBERRY PI? 
The Brompton team have investigated other single- 
board computers, aiming to identify the most cost- 
effective platform that could offer the power and 
flexibility needed for low-friction deployment into 
a broad range of applications. They concluded that 
Raspberry Pi offered both superior performance 
and better value than other boards on the market. 
“We’ve done a lot of research,” reflects Tracey. 
“There are plenty of other small credit-card-sized 
PCs that come out, and they don’t match Raspberry 
Pi. We’ve tested them and there’s nothing on the 
market that compares. Not just for performance, 
but also for value.” 

As production volume has increased at 
Brompton, strict time targets have become 
ever more important to their operations, Tracey 
emphasises. “The Raspberry Pi now is critical in our 
manufacturing. We have to stick to the take time, 
we have to stick to how many bikes we get out. And 
this is what the Raspberry Pi does for us: it helps us 
reach those targets.” 
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THE RESULTS 


Each Brompton bicycle is a masterpiece of 
perfection in design and technology, reflecting 
the pride Brompton assembly operators take in 
ensuring that every machine is constructed to the 
very highest possible standards of quality. 
Raspberry Pi plays a crucial role in Brompton’s 
assembly processes, ensuring critical elements 
such as the application and capture of the correct 
torque — essential for the safety of the rider - as 
well as capturing every other aspect of the build 
process through each station of the assembly line. 
Butler-Adams is clear about the impact of 
Raspberry Pi at Brompton. “It gives us insight, 
allows us to adjust, it gives us traceability, it helps 
training. And I have visited a lot of factories: I’ve 
never seen a system as slick as the system we’ve 
created ourselves with the humble Raspberry Pi.” 


maa 
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SUBSCRIBE TODAY AND GETA 


A brand new 
RP2040-based 
Raspberry Pi Pico W 
development board 


Learn to code with 
electronics and build 
your own projects 


Make your own 
home automation 
projects, handheld 
consoles, tiny 
robots, and much, 4 This is a limited 


h offer. Not included 
much more , re with renewals. Offer 


subject to change or 
withdrawal at any time. 


SUPER SIMPLE 
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aspberry Pi Pico W is an incredible 
development board, built around the 
powerful RP2040 microcontroller. 

On both sides of Pico W sit GPIO (general- 
purpose input/output) pins. There are 40 of them 
in total. These pins are used to interface Pico W 
with the wider world. You use them to wire up 
electronics components, attach Pico W to computer 
equipment, and build personal projects. 

This is the real joy of Pico W (and Raspberry Pi 
computers). These pins are where code interfaces 
with the real world. You can use Pico to automate 
your home, control robots, or manage household 
appliances. Or, you can simply mess around with 
buttons, buzzers, sensors, and build fun widgets 
and gizmos. 

Also, thanks to Pico W’s wireless capabilities, 
you can now interact with online services, 
pulling in data from the internet via APIs 
(application programming interfaces), and 
information wirelessly. 


storing 


7S 
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PICO W WITH HEADERS 
This Pico W has been 
populated with two headers 
(small pins soldered to the 
GPIO holes). This enables it to 
be attached to the breadboard 
for prototyping. You can also 
solder wires and components 
directly to the GPIO holes, but 
most newcomers start with 
headers. Pico WH, sold with 

a header attached, will be 
available to buy soon. 


JUMPER LEADS 
Jumper leads are 
used to connect the 
various components to 
one another and to the 
GPIO pins on Pico W, 
forming a circuit. 


COMPONENTS 

Our board here has two 
components: a small LED 
(light-emitting diode) and 
a resistor (which is used 

to reduce the voltage and 
protect the LED). Around 
the board are some other 
components you will 
frequently encounter, such y 
as buttons, light and distance BREADBOARD 
sensors, and a small display. A breadboard is a white 
slab of plastic populated 
with holes. Each hole 

in a row is connected, 
enabling you to connect 
wires and components 
by putting them in a hole 
in the same row. 


MonkMakes » £15/$20 


Coming from The MagPi regular Simon Monk, this 
kit features ten well-documented projects ina 
downloadable 68-page book. It also contains a 
breadboard, LEDs, buttons, a phototransistor, and 
a piezo buzzer, plus jumper leads and resistors. 
Projects include a light meter, thermometer, and 
fader. A great starter option. 
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Pimoroni » £35/$43 


Get Started with MicroPython on 


Raspberry Pi Pico 


Created by the team 

at Raspberry Pi Press, 

this book is packed with 
official information on how 
to program Pico with the 
MicroPython language. 


Raspberry Pi's website has 
a stack of documentation 
designed to introduce 
you to all the details that 
make up Pico. 


If you are stuck with a 
problem, or want to see 
what folks are saying 
about Pico W, then 
bookmark Raspberry 
Pi's dedicated Pico 
forum page. 


Gy 


MAKER 


n The MagPi issue #119, we introduced 

Raspberry Pi Pico W. Based around 

Raspberry Pi’s own RP2040 microcontroller, 
Pico W brings 802.11n wireless networking to 
the family of Pico boards. 

This means that your Raspberry Pi Pico W 
can now talk to the network, but also that the 
network can talk back to it; and you can runa 
web server on your Pico W to allow you to control 
things remotely. 

You’ll need to attach GPIO headers to Raspberry 
Pi Pico W and use a breadboard with an LED light 
for this tutorial. Set everything up as shown 
in Figure 1. 


Figure 1 Connecting your Raspberry Pi Pico W to a LED 


Installing MicroPython 

The fastest way to get MicroPython is to 
download the pre-built release binary from the 
Documentation pages (magpi.cc/micropython). 

Then go ahead and push and hold the BOOTSEL 

button, and plug your Pico W into the USB port of 
your computer. Release the BOOTSEL button after 
your Pico W is firmly connected, and it will mount 
as a mass storage device called RPI-RP2. Drag and 
drop the MicroPython UF2 file onto the RPI-RP2 
volume. Your Pico W will now reboot. You are now 
running MicroPython, and you can now access the 
REPL via USB Serial. 


Controlling a LED via the web 
When you’ re writing software for 
hardware, turning an LED on, off, and then on 
again is typically the first program that gets run in 
a new programming environment. Learning how 
to blink an LED gets you half way to anywhere. 
We’re going to do exactly that, via a web browser. 
We are in fact going to build a RESTful(ish) web 
server to control our LED. 
We’ve chosen to attach an external LED to GP15 
of our Raspberry Pi Pico W, but you could just as 
easily use the on-board LED for testing things out. 
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The LED light 
is connected 
to Pico W's 
GPIO pins via 
jumper leads 
and a resistor 


GPIO header pins are soldered to 
Pico W and the board is attached 
to an electronics breadboard for 
circuit prototyping 


Getting started 


More information 
on setting up 
Pico W can be 
found in this 
online tutorial: 
magpi.cc/ 
setuppicow. 


Running our Python 
script on Pico W from 
the Thonny editor 


@ Thonny - Raspberry Pi Pico :: /ap.py @ 9:19 


while True: 
try: 
cl, addr = s.accept() 
print('client connected from’, addr) 
request = cl.recv(1824) 
print(request) 


request = str(request) 

led_on = request. find(‘/light/on') 
led_off = request.find('/light/off') 
print( ‘led on = ‘ + str(led_on)) 
print( ‘led off = ' + str(led_off)) 


if led_on == 6: 
print(“led on”) 
led.value(1) 
stateis = “LED is ON" 


if led_off == 6: 
print(“led off") 
led.value(@) 
stateis = “LED is OFF” 


response = html % stateis 


cl.send('HTTP/1.6 268 OK\r\nContent-type: text/html\r\n\r\n') 


cl.send(response) 
cl.close() 


>>> 


connected 
ip = 10.3,.15.120 
pen (0.0.0.0, 80) 


Start Thonny 

Open Thonny, and upload the webserver.py 
Python script to your Pico W. If you haven’t used 
MicroPython and Thonny before, full instructions on 
how to do that can be found in the Raspberry Pi Pico 
Python SDK book (magpi.cc/picopythonsdk). 

Make sure to replace the and with 
the name and password for your own wireless 
network at home, and then hit the button to run the 
script on your Pico W. 


Light on 

After your Pico W connects to your wireless 
network, you should see the IP address for your 
board appear on the REPL inside the Thonny 
shell window. 

To control the LED, you can open up a web browser 
and go to http://10.3.15.120/light/on to turn the LED 
on, and http://10.3.15.120/light/off to turn the LED 
off again. 
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You should substitute your IP address, which 
for most home networks will probably be in the 
192.168.1.X range, for the one shown here. 


Going further 

This example lets you remotely turn an 
LED on, and then off again. However, we can also 
extend this example to add buttons to the web 
page we’re serving to allow you to control the LED 
directly from a web interface rather than by using 
a RESTful server — which, after all, is more suited 
to programmatic use rather than working from 
a web browser. Alternatively we can go further 
and reimplement our server, so that rather than 
blocking, it will operate asynchronously. 

More information about connecting your 

Pico W to the web can be found in the online 
documentation and the Connecting to the 
internet with Raspberry Pi Pico W book: 
magpi.cc/internetpicow. 


DOWNLOAD 
webserver.py THE FULL CODE: 


> Language: Python iw) magpi.cc/github 


Q01. import network 041. 

@@2. import socket @42. s = socket.socket() 

003. import time 043. s.bind(addr) 

e004. 044. s.listen(1) 

@e@5. from machine import Pin 45. 

ee6. 046. print('listening on', addr) 

@@7. led = Pin(15, Pin.OUT) 047. 

ee8. 048. # Listen for connections 

@@9. ssid = ‘YOUR NETWORK NAME' @49. while True: 

@1@. password = ‘YOUR NETWORK PASSWORD" Q50. try: 

@11. e51. cl, addr = s.accept() 

@12. wlan = network.WLAN(network.STA_IF) 52. print('client connected from', addr) 

@13. wlan.active(True) 053. request = cl.recv(1024) 

@14. wlan.connect(ssid, password) 54. print (request) 

e15. Q55. 

616. html = """<!DOCTYPE html1> e056. request = str(request) 

@17. <html> @57. led_on = request.find('/light/on') 

18. <head> <title>Pico W</title> </head> 058. led_off = request. find('/light/off') 

e19. <body> <h1>Pico W</h1> e59. print( ‘led on = ' + str(led_on)) 

@20. <p>%s</p> 060. print( ‘led off = ' + str(led_off)) 

21. </body> 061. 

@22. </html> Q62. if led_on == 6: 

@23. """ 063. print("led on") 

24. 064. led.value(1) 

@25. max_wait = 10 065. stateis = "LED is ON" 

Q26. while max_wait > @: 066. 

@27. if wlan.status() < @ or wlan.status() >= 3: 067. if led_off == 6: 

e28. break 068. print("led off") 

@29. max_wait -= 1 e69. led.value(@) 

30. print('waiting for connection...') e70. stateis = "LED is OFF" 

31. time.sleep(1) e71. 

Q32. 72. response = html % stateis 

@33. if wlan.status() != 3: 073. 

34. raise RuntimeError( 074. cl.send('HTTP/1.@ 200 OK\ 
"network connection failed’) r\nContent-type: text/html\r\n\r\n') 

@35. else: e75. cl.send(response) 

36. print('connected') e076. cl.close() 

37. status = wlan.ifconfig() Q77. 

38. print( ‘ip = ' + status[@] ) e78. except OSError as e: 

@39. e79. cl.close() 

040. addr = socket.getaddrinfo('0.0.0.0', 80)[@][-1] e80. print('connection closed') 
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Exploring electronics with 
a Pico Breadboard Kit 


Raspberry Pi Pico W brings physical computing and the internet together and 
it's never been easier, Let's learn the basics by making a weather indicator 


PJ Evans 


PJ is a writer, 
software engineer 
and general 
tinkerer. He can 
currently be found 
replacing all his 
old microcontroller 
projects with 
Raspberry Pi 

Pico Ws. 


@MrPJEvans 


| You'll Need 


» SB Components 
Pico Breadboard kit 
magpi.cc/ 
picobreadboardkit 


» 2x 20-pin headers 
(if not already 
there) 
magpi.cc/ 
picoheaders 


» 10 x Female-female 
jumper cables 
magpi.cc/ 
jerkyjunior 


» Micro-USB to USB 
cable suitable for 
your computer 


capability has got you eager to start making 

but you’re not sure where to start, you’re in 
the right place. We’re going to take a step-by- 
step look at simple components for inputs and 
outputs, connect them to Pico W, and then fetch 
data from the internet and display them. We’re 
going to do this without any of the difficulty of 
soldering, or even handling components, by using 
the SB Components Pico Breadboard kit. This PCB 
(printed circuit board) comes pre-populated with 
buttons and LEDs to make your introduction to 
electronics as simple as possible. 


[ f the new Raspberry Pi Pico W’s wireless LAN 


Pico preparation 

A great facet of Raspberry Pi Pico W 
is its support for different languages. By 
uploading different ‘firmwares’ (low-level code 
that translates for the RP2040 CPU), we can 


13a 0 <e 
[euttionpy} — [ledpy} = <uttied> 
import tine 


import network 


ss 


= “Se o@ Save 10 Raspoerry Pi Pice 
password = 


when = set) Raspberry Pi Pico 
wlan. active 
wlan. commee | Name 
© vaton py 
carwait = Ortor 
while maxs 
it wu 
bre 
eo 
print 


tine.5 


Fema: [witiny a * 


MecroPython (Raspberry Pi Pico) 


A You can write code as files and upload them directly to 
Pico W. To have code run instantly when Pico W is plugged 
in, just name it main.py 
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write programs in different ways. We’re using 
MicroPython, a microcontroller flavour of Python, 
which greatly simplifies writing code for Pico W. 
It also includes everything we need to connect to 
the internet. To download and install the latest 
version of the MicroPython firmware, follow the 
instructions here: magpi.cc/micropython. 


Get ahead 

To connect to the Pico Breadboard Kit, 
you will need to have headers soldered onto your 
Pico. If you do not have a Raspberry Pi Pico H (H 
or headers), then you need to buy a header kit 
and solder them on yourself. These need to be 
acing downward so the smaller part of the header 
is poking through the top of Pico’s PCB on the 
RP2040 chip side. If soldering yourself, remember 
to be careful and start by soldering each end pin of 
the header block, then check everything is level. 
f not, you can melt the solder to move them into 
place, then solder all the ones in between. 


Choosing a development 

environment 
To write code for Raspberry Pi Pico W, you need 
to use acomputer. Nearly any modern operating 
system will do, including Raspberry Pi OS. It’s 
possible to write code using a simple text editor, but 
it’s a lot easier (and faster) to use an IDE (integrated 
development environment). Don’t be put off by the 
fancy name - this is a text editor that understands 
what a Pico W is and can help transfer programs. 
On Raspberry Pi OS we recommend Thonny, but you 
can also use Visual Studio Code with the Pico-Go 
extension. More info: magpi.cc/gettingstartedpico. 


ETS) os 


esti: pe 
use 


» © y 


UTTON 2 BUTTON 3 


Raspberry Pi Pico W can plug 
straight into the prototyping board 
with all GPIO pins accessible 


Testing time 

It’s time to check everything is working. 
Connect your Raspberry Pi Pico W to your computer 
using a USB cable. Open up Thonny and look in the 
bottom right-hand corner. It should say something 
like ‘Python 3.7.9’. Click on this and, if Pico W 
has been recognised, you’ll see ‘MicroPython 
(Raspberry Pi Pico)’ as an option. Select this and 
you’ll see a welcome message on the bottom half 
of the screen. Click to the right of the ‘>>>’ prompt 
and type: 


print('Hello') 


... followed by pressing RETURN. If you see ‘Hello’ 
displayed in response, you’ve just run your first 
program on your Pico W! 


Understanding LEDs 

Have a look at the SB Components 
prototype board. On the bottom-right are four 
LEDs (light-emitting diodes). These are one of the 
most common components used when beginning 
electronics, as we can make them light up and 
that’s cool! LEDs can be a little naughty and 
draw too much current if left unchecked, causing 


The on-board buttons and 
LEDs can be easily wired 
to Raspberry Pi Pico W 
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permanent damage. To stop this happening, we 
need an in-line resistor to limit the flow of current. 
See the little black and silver squares above the 
LEDs? They are 330 ©. resistors already in place that 
are perfect for the job, so we can wire everything 
up without worrying about damaging our LEDs. 


We are using the RP2040's built-in 
‘oull-down' resistor circuit which solves 
this problem 


Understanding buttons 

On the left-hand side of the prototyping 
board are four buttons (and a buzzer, but we’ll 
get to that). Each button creates a circuit when 
the button is pressed down. By wiring these to 
your Raspberry Pi Pico W, you can detect when 
the button is pressed. Buttons can be tricky for 
a microcontroller to handle, as the input is so 
sensitive it can give inaccurate readings; you can 
even trigger it by putting your finger next to it. To 
prevent this, we are using the RP2040’s built-in 
‘pull-down’ resistor circuit which solves this 
problem. When it comes to coding, you’ ll see how 
we make use of it. 
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TopTip & 


Keep it in order 


LEDs or buttons 
not working in the 
right order? Check 
the wiring, it’s 
really easy to get 
things the wrong 
way around. 


P» LEDs require in-line 


resistors to prevent 
them drawing too 
much current. Here, 
those resistors are 
already provided 


07 Get wired 

It’s time to assemble our circuit. Carefully 
insert the disconnected Raspberry Pi Pico W into 
the socket on the prototype board, with the USB 
end at the top. The LEDs and buttons connect to 
Pico W using jumper cables. Between the buttons 
and the LEDs you’ll see two yellow sets of headers, 
clearly labelled. The jumper cables need to run 
from these to the GPIO pins on Pico W. If you’re 
wondering where the ground connection is, look at 
the top-right of the board. The GND header must 
have one wire connected to any of the GND pins on 
Pico W. Follow the wiring table (overleaf) carefully. 


Light up the LEDs 

Having checked all your wiring carefully, 
connect Raspberry Pi Pico W to your computer. 
In Thonny, type the leds.py code listing into the 
upper window, and then click the ‘Run’ icon. 
When prompted, ask to save it on the Pico W and 
name it leds.py. The code will now be uploaded 
to Pico W. Do you see the LEDs coming on one- 
by-one? The code starts by telling Pico W which 
GPIO pins are connected and what they are for 
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(in this case - output). Then we go into a loop: 
toggling the state of each pin, then waiting a 
second. If you want, have a play with the sequence 
or see if you can change timings. 


Push the button 

To check the buttons, create a copy of the 
file you created in Step 8, and call it buttons.py. 
Remove the block starting while True:, then add 
the contents of the buttons. py code listing. Save 
and run the code. Try pressing the buttons one by 
one. Each one should now toggle its equivalent 
LED. This code uses ‘event’ or ‘interrupt’ handlers, 
blocks of code that run when a GPIO pin changes 
state. When a button is pressed, the code runs and 
changes the state of the LED. This is a fundamental 
part of physical computing. You are taking external 
input (the button) and creating output (the LED). 


Simon says 
You’ve now seen how Raspberry Pi 
Pico W can use code to respond to inputs by 


corsectet 
ip = 192.168.5.96 


MicroPython (Rasobery P Pico} 


A With a few lines of code, Pico W can connect to your 
wireless network and then to the internet 


creating outputs. We could have wired the buttons 
directly to the LEDs to create a similar effect (and 
using the breadboard, you can try that!), but Pico 
W adds logic that would be hard to implement in 
raw circuitry alone. To demonstrate this, download 
memotry.py from magpi.cc/memorypy. This is an 
extension of the code that turns our button script 
into a memory game. Run the code on your Pico W, 
and see if you can remember the sequence of LEDs 
by playing them back on the buttons. Don’t forget 
to review the code and see how it works! 


™ |f you're wondering where 
the ground is, look at the 
top-right of the board @ 


Get online 

Now we have built our circuit, tested it, and 
played a game, let’s look at what makes Raspberry 
Pi Pico W so special. For our weather project, we 
need to connect to the internet, so let’s start with 
that. Create a new file called wifi.py and add the 
contents of the wifi.py listing (overleaf). Replace 
the ssid and password values with those for your 
own network. Now run the code on your Pico W 
using Thonny. Watch the console output and 
within a few seconds you should get an IP address 
announcement, meaning you’re on the internet! 


A key step 

We’re going to get some weather info 
to display on our prototype board. We’1l use 
openweathermap.org to supply information 
using an API call. This is just like getting a web 
page, except the information is returned in a way 
computers can easily understand (in this case 
JavaScript Object Notation, or JSON). Sign up fora 
free account on the site and, once logged in, go to 
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DOWNLOAD 


leds.py THE FULL CODE: 


© magpi.cc/ledspy 


» Language: Python 3 


Q@@1. from machine import Pin 

Q@2. import utime 

0e3. 

004. # Make sure these are the pins connected to your LEDs! 
005. leds = { 


06. 1: Pin(28, Pin.OUT), 

e07. 2: Pin(27, Pin.OUT), 

ee8. 3: Pin(26, Pin.OUT), 

ee9. 4: Pin(22, Pin.OUT), 

e10. } 

011. 

@12. # Loop through the LEDs toggling each one then sleeping a 
second 

@13. while True: 

e14. for i, (k, led) in enumerate(leds.items()): 

Q15. led.toggle() 

e16. utime.sleep_ms(1000) 


DOWNLOAD 
THE FULL CODE: 


'y) magpi.cc/buttonspy 


buttons.py 


» Language: Python 3 


001. # Remove the while True: block and replace with this 
@@2. def button_handler(pin): 


0e3. button_pressed = int(str(pin)[4:6]) - 17 

004. print(str(button_pressed) ) 

005. leds[button_pressed].toggle() 

006. 

007. for gpio_number in range(18, 22): 

008. button = Pin(gpio_number, Pin.IN, Pin.PULL_DOWN) 
ee9. button. irg(trigger=Pin.IRQ RISING, handler= 


button_handler) 


‘API Keys’. One will have already been created for 
you (although it can take an hour or two to start 
working). Think of this as a password allowing you 
to access the service. Take a copy — you’re going to 
need it soon. 


Talk about the weather 
We’re going to make a request for the 
current weather. Download weather_1.py from 
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MéigPi 


These handy 

jumper cables make 
connecting the LEDs 
and buttons to 

Pico W easy and safe 


Here are the 
connections you need 
to make between 
Pico W and the button 
and LED connectors. 
Be careful and don't 
forget the GND! 


GP28 
GP27 
GP26 
GP22 
GP21 
GP20 
GP19 
GP18 
GND 


magpi.cc 


magpi.cc/weatheripy, then replace the three 

new variable values at the top with the API from 
the previous step and your desired latitude and 
ongitude. Don’t know these? Just enter ‘lat and 
ong for town’ in a search engine, and you’|l get the 
answer. The ones in the code are for the Raspberry 
Pi Foundation in Cambridge. Run the code on 

your Raspberry Pi Pico W as before, and watch the 
console output. Here, we use the urequest library 
to request information from the API server. 


Any 
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Hooking up the buttons 

We've got four buttons, so let’s pick out 
four key pieces of information. Each time we press 
a button, a request will be made to the API and 
the code will extract a useful piece of data from 
the request. We’re going to ask for temperature, 
windspeed, rain, and air quality index. This code 
is a little longer, so download weather_2.py from 
magpi.cc/weather2py and transfer it to your 
Raspberry Pi Pico W as before. Run the code and 
press each button. Watch the output in the console 
as you press the buttons. 


Enter ‘lat and long for town’ 
in ag search engine, and 
you'll get the answer 


Lightening 

We don’t have a screen (although you can 
add one if you want!), just four lights to show 
the data. What we’ll do is divide the results into 
ranges and light the appropriate amount of 
lights. For instance, If it’s really hot, all four LEDs 
will illuminate. Download weather_3.py from 
magpi.cc/weather3py and run it. Raspberry Pi 


A You could use a standard breadboard and components, 
but the Pico Breadboard Kit makes it all a Lot easier 


Pico W will download the JSON data and extract our 
four data points and display them using the LEDs. 
Feel free to change the ranges if you wish. 


Buzzin’ 

Calls to the internet can never be fully 
relied on to succeed. There are many things that 
can go wrong, from your internet connection 
being down to the API server having problems. 
We can catch these errors and signal to the user 
that there’s a problem. The next version of our 
code (weather_4.py from magpi.cc/weather4py) 
creates a short buzz on successful calls anda 
longer buzz if something went wrong. Keep getting 
errors? More details will be logged to the console. 


17 Put it all together 

Let’s bring the buttons and the LEDs 
together. Download our final code version, 
weather_5.py from magpi.cc/weather5py, and run 
it up as before. Now when you press each button, 
you can get an idea of whether it’s raining, sunny, 
hot, or windy! Take some time to walk through 
the code to see how we hunt through the data, 
and see what changes you can make! If you would 
like to run this independently without a computer 
attached, just rename this file to main.py. Any file 
of that name will run automatically when power 
has been applied to Raspberry Pi Pico W. 


A To get the weather data you need an API key. You'll find it 
on the OpenWeatherMap user page like this 


Make it your own 

In this tutorial we’ve learnt how to control 
LEDs, listen for button presses, and combine 
those with internet data. Feel free to alter the 
code to show different things. Maybe you could 
periodically check the API and sound the buzzer 
when it’s raining? This is just the beginning! 
For such a low-cost device, the capabilities of 
Raspberry Pi Pico W go much further than switches 
and lights. You can add all kinds of sensors, 
screens, and even motors with the right kit. Get an 
electronics kit and use the breadboard to add more 
features. There are endless tutorials out there to 
help you along. Be curious and have fun! i 


wifi.py THE 


» Language: Python 3 
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TopTip & 


More data 


OpenWeatherMap 
offers different 
APIs, many for 
free, so it’s worth 
exploring what 
other data you 
could get, such as 
UV warnings. 


DOWNLOAD 


FULL CODE: 


@ magpi.cc/wifipy 


001. # Based on code by Pete Gallagher 

@@2. # https://www.petecodes.co.uk/ 

003. import time 

004. import network 

ee5. 

e@6. ssid = "<Your Wifi Network Name>" 

@@7. password = "<Your Wifi Password>" 

008. 

@@9. wlan = network.WLAN(network.STA_IF) 
@10. wlan.active(True) 

@11. wlan.connect(ssid, password) 

12. 

@13. # Wait for connect or fail 

Q14. max_wait = 10 

@15. while max_wait > 0: 

e16. if wlan.status() < @ or wlan.status() >= 3: 
Q17. break 

018. max_wait -= 1 

@19. print('Waiting for connection...') 
Q20. time.sleep(1) 

21. 

@22. # Handle connection error 

@23. if wlan.status() != 3: 

@24. raise RuntimeError( ‘Network connection failed’) 
@25. else: 

@26. print('Connected') 

@27. status = wlan.ifcontig() 

Q28. print( 'IP Address = ' + status[@] ) 
29. 

@30. # Important to tidy up the connection 
@31. wlan.disconnect() 
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Rob Zwetsloot 


Rob is The MagPi 
Features Editor, 
and he sometimes 
fancies himself a 
game developer 
when he's not 
playing games. 
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| You'll Need 


> Latest Raspberry 
Pi OS 


» Game sprites 


>» Pygame library (on 
other systems) 
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MagPet — code a 
Python virtual pet 


Virtuadl pets are back! At least here in the magazine, as Rob Zwetsloot 
revives a nineties phenomenon on a Raspberry Pi 


virtual pets are still going strong today? 

Your Tamagotchis, Digimons, and weird 
alien-themed knock-offs are still around with 
improved functionality. They’ re still stuck in their 
little plastic bodies though, so we thought it was 
high time we made one from scratch that you can 
play on your Raspberry Pi desktop. No magical 
crest required. 

Make sure you’re on the latest version of 
Raspberry Pi OS on your Raspberry Pi, and update 
all the software. Alternatively, you can make this 
on another computer, as long as you install the 
Pygame library. 


D idya see, didya hear, didya know that 


Get your art 
We’ve provided code and art on our GitHub 
at magpi.cc/magpet. However, our images are 
really just placeholders to make sure it all worked. 
You’ll need at least one image for your pet (ours 
has a basic two-frame animation cycle), different 
heart images for happiness, a graphic for when 
your pet is hungry, a picture of poop, and we also 
used graphic buttons we made ourselves. Save 
them in a directory where your Python code is. 
Using pygame. image. load,you can set the image 
file to be a variable name, making calling upon it 
easier in the code. 


Basic parameters 

For our version of a virtual pet, we’ve only 
imported Pygame (which does include a lot of 
functions of its own) and the random module for 
part of the movement cycle. 


code a Python virtual pet 


M..et » 


Our monster friend moves 
around this enclosed 
space just Living their life 


Happiness, hunger, and 
the state of their living 
area all affect the monster 


ce 


Manage your monster 
by making sure to clean, 
feed, and even pet it 


The game screen will be 200 pixels by 300 
pixels wide in our code. However, if you have large 
sprites, you may want to increase this. 


We’ve made the background colour the same as 
a classic Tamagotchi with RGB, and decided to put 
the pet in the centre of the screen to start. We’ve 
also created some global parameters for health and 
happiness, walk cycle stage, etc., so that the screen 
updates properly along the way. 


Move your pet 

Our pet is going to move on its own. We'll 
handle the direction later on but, for now, we have 
two functions: pet and movement. 

Movement uses cardinal directions translated as 
numbers (1 = North, 2 = East, etc.) which is selected 
in the main game code. We move the creature ten 
pixels in those directions, but also check to see if 
we’re at a boundary so that the pet does not move 
any further. 

Using these co-ordinates, we set the location 
of the pet in the next frame of the game - we also 
cycle between the different images that make up 
the walk cycle. 


Handle health 
What is the goal of this game? To keep our 
pet happy and healthy. On screen, three hearts are 


import pygene 
import random 


$ Game info 


display_vidth = 200 
dseplay_height = 300 


Be_colous = (160, 178, 129) 


pet_x = 100 
pet_y = 100 


uM 4 Variables for the pet 


hunger = 2 
happiness = 20 
vaste = 6 

2 vastexy = () 

20 butron_press = 0 

2 pet_counter = 9 
valk_cycle ~ 0 


24 s&s Images, incloding two images for pet idle animation 


pet_i = pygame. image. load(" sprit 
pet_2 = pygame. image. load("opri 
fall_heart « pygame. image. load( 
halt_beart = pyyane. image. load( 
empty_neart = pygeme.szage.load 
hungry = pygame.image.load("= 
2 - poop = pygame. image. Lead ("9p ri 
}  Clean_button = pygame.image. load 
34 feed_batton = pygame. image, load 3 
5 - pee_Burten = pygame.image.load("spziter/pet.png") 


¢ Game functioas 
# Pet Location 


Eidet pet (pet_x,pet_y.gene_dssplay) = 
global walk cycle 
if walk_eysle == 0: 
game_display.biitipet_i, (pet_s,pet_y)) 


else: 
game_cieplay-Diac(pet_2, (pet_z,pet_y)) 


A Figure 1 Lines 1 to 35 cover the first two steps. 
Here, we get everything set up for the rest of the code 


PFOPENGAMERRT.ORG 


ee 


ave? 


Acina Forum Torscs -( 


used to show how happy the pet is, with each heart 
being made up of 20 happiness points behind the 
scenes. We’ve created a series of if statements 

to build up the heart graphics, for full, half, and 
empty hearts. 

As the pet relieves itself, it will deposit waste 
around the screen. The function poopxy keeps track 
of where it’s gone, and we’re very careful to make 
sure only one appears at a time. Each time a new 
poop appears, its co-ordinates get appended to 
a tuple. 


Game loop 

Each loop of the game, our pet goes through 
a cycle. It will get hungrier, need to relieve itself 
more, and also will lose happiness if you’re 
not paying it attention. We’ve also set it up so 
happiness is affected by hunger and cleanliness, 
so make sure to keep your pet fed and clean. When 
our pet is at a certain level of hunger, a little 
thought bubble appears to prompt you to feed it. 

The button_pressed function checks to see where 

your mouse was when it clicked. This method of 
tracking pixels is a very basic way to press buttons 
in Pygame. 


Main loop 

We start the main loop by getting the rest 
of Pygame set up. This includes a clock to make 
sure each frame passes at a certain point, creating 
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Now Aas Cocincrions - ( ) 


A For protoyping 
software that needs 
graphics, you'll find 
just about anything 
you'll need on 
OpenGameArt.org 
for free 
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What's in 
dname 


Tamagotchi is a 
portmanteau of 
tamago/egg and 
tomodachi/friend 
in Japanese. 
They're shaped 
like eggs after all. 
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def sovenent (move, game_display): 
global pet_x, pet_y 
tf move == i 
pet_y -= 1 
tf move == 2 
pet_x om b 
. af mve 
P Figure 2 Step 03 foan 
covers the last few if move == 
lines of Figure 1, and vA pea Co 
also the movement pet_x = 
part until line 68 Af pas_k> 2 
: pet_x = 
Happiness is shown at pet_7 < 
using the hearts pet_y = 1 
function, explained in ee "eerie cid 
Step 04 =! 


det hearts (game_displey): 
global happiness 

ar hap, 

game_dieplay bla: 

if hap 

game_displa 

happiness > 


came_cisplay. 
if happiness > 34: 
game_dsaphay 
af happiness < 
game_di spla 
if happiness > 
game_cispie: 
if happiness > 
came_di splay. 


(120,245)) 


at (full_heart, (120,215) 


the game display, and importing all the variables 
we need. 


Mm We decided that it wouldn't 
just move randomly 
each frame @ 


Now the full while loop starts. The screen is 
filled with colour, the buttons are placed on the 
screen, and the mouse co-ordinates are set to 0. 

As this part is being called for each frame, it’s 
best to keep as little out of it as you can to make 
sure your game runs as fast as possible. For this 
script, the global parameters and unchanging 


Top Ti p a display aspects were placed before the while loop 
for this reason. 


Size can 
matter 


The size of your 07 Handling inputs 

screen and sprites In this project, we have two kinds of 

need to match in inputs: a mouse click, which we’re using to press 
someway = Ns the buttons on screen, and also the exit button on 
easier to resize . 

images out of the Pygame window. 

Python after all. The pygame.QUIT event is fairly simple. If the X 


on the window is pressed, Pygame will stop. QUIT 
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is the ‘event’ Pygame receives when you click 
on the X. 


As for the mouse, we wait until the button goes 
up, hence MOUSEBUTTONUP is the event. This means 


it won’t count you having the mouse button 


depressed as multiple events over several frames 


if you don’t click fast enough. You may have 


seen variations on this with how buttons work in 


GPIO Zero. 


Movement philosophy 


Here’s where we set the cardinal directions 


of the pet. We decided that it wouldn’t just 
move randomly each frame, and it would in fact 
have a 60% chance to carry on in any direction 
it started. This is where the random module 


comes in. In action, this means our pet will move 


more naturally. 
The cardinal direction and the game_display 
variable are sent to the movement function from 


Kiet poopxy (wasve,pet_x,pet_y,gane_dsepiay) 
global va , 


(waste) > len (wastexy) : 
my [{ (int (waste) }~1)} = ((pet_x + 5), pet_y) 
prev_vaste = int (waste) 


for $ in va 
game_display.blit (peop, wastexy[i}) 


Kiet pet Le(pet_x, Pty, game_display): 
Global hunger, happiness, waste 
it ex < 


y.blit (hungry, ((pet_x + 25), (pet_y ~ 30))) 


happiness -= 

hunger > § 

happiness <= 
hearts (game_display) 
f waste < 5 


waste += 
(waste) > 0: 
y (Waste, pet_X,POt_y,Game_display) 


(mousex, mousey): 


if mousex >= ¢ and mousex <= 60: 
return 1 

@LIE MouseX >= TO and mousex <= 
return 2 

elif mousex >= 140 and mousex <= 2 
return 3 

else: 
returns 


A Figure 3 Waste is managed as shown in Step 04, and 
from 106 to the end are the functions that handle your 
interactions and how your pet lives as shown in Step 05 


Step 3. We pass on game_display so that the 
function can update it properly. 


Button juggling 

There are three buttons on this pet, which 
means there are four states to keep track of. 
We’ve tried to keep it simple and understandable 
by labelling the buttons 1-3, and no button being 
0. One thing we did was to make sure we couldn’t 


just hammer the Pet button to increase happiness. 


A timer is set so that you have to wait five frames 
before using it again. 

As each frame is rendered separately, this 
means if you reset hunger and waste, the 
images for them will not be rendered in the 
following frame. 


m We're planning to connect 
ours to web APIs 


Game Over...? 

How do you lose the game? Well, you need 
to take care of your pet, so if your pet gets as 
hungry as it can be (10), fills up its space with 
waste (5), and loses all happiness (0), it will be 
game over. On original Tamagotchi devices, they 
would run away. In our case, the game will just 
stop and you’! have to start again. 


Actual play 

If your code has made it this far, it’s time 
to update the frame. All the important movement 
and location functions are called, the cycle is 
updated, and everything is rendered. As each 
frame goes by, this gives the illusion of life, and 
limited time to keep at it. 

One important part of the end of the loop is 

clock.tick(). It’s used to set a frame rate, witha 


if happiness < © and inti(waste) == 5 
| print [ ) 
else: 


and hunger > 


pet_cycle(pet_x, pet_y, game_dispiay) 
lay updace () 


ower number meaning fewer updates. As virtual 
pets of old would have very limited movement, we 
found that 2 simulated a good, slow-moving pet. 
You can always change it depending on the speed 
of your hardware. 

Finally, the main function is run. 
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DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/magpet 


< Figure 4 This block 
of code handles 
Step 06 (144 to 158), 
Step 07 (160 to 166), 
Step 08 (168 to 177) 
and finally Step 09 
for the rest 


Figure 5 The game is 
played out through 
this last bit of code, 
described in Steps 10 
and 11 


Improvements 

There’s plenty you can do to upgrade this. 
Better graphics, better buttons, and a tighter 
adherence to the boundaries as well for starters. 
You could also add other features like your pet 
going to sleep for a while, or have it properly run 
away when it’s game over. You could have a status 
screen with age, and even name it. 

We’re planning to connect ours to web APIs 

in the future to see if the internet can properly 
look after a virtual pet. We don’t have high 
hopes though. Hi 
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Sean 
McManus 


Author of Mission 
Python, Scratch 
Programming in 
Easy Steps, and 
Raspberry Pi For 
Dummies (with 
Mike Cook). Get 
free chapters at 
Sean's website. 


sean.co.uk 


| You'll Need 


» Raspberry Pi 
» Raspberry Pi OS 
» Internet connection 


» Display-O-Tron HAT 
(optional) 
magpi.cc/ 
displayotron 


» Pibow case 
(optional) 


Build a 


Raspberry Radio 


Create your own virtual radio station, with a DJ that reads out the 
news and weather and announces your songs before they play 


e love radio, but don’t you ever wish 
W you had more control over the playlist? 

With Raspberry Radio, every song is 
your request. You give it a collection MP3 files, 
and the virtual DJ plays them at random, telling 
you something about each track. After a few 
songs, it’s time for the news and weather. In this 
tutorial, you’ll see how to download the news 
headlines using an RSS feed and access your local 
weather through an API. Next issue, we’ll get the 
DJ talking and cue the music. You can download 
the code at magpi.cc/newsreader. 


Install Python modules 

We’ll be using two new Python modules for 
this project. It’s quick and easy to install them. 
The requests module downloads content from the 
web using HTTP requests. The feedparser module 
is used to process RSS feeds, which many news 
websites use to share headlines, summaries, and 
links to their stories. Click the Terminal icon on 


© Code Beautify - 
Python Formatter 9 Lie] + - | 


a ve OD 8 0 0 “BRI 


° 


A This Python Formatter makes it much easier to understand 
the JSON structure of the weather data we're using 
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your taskbar to open a terminal window. Then 
enter the following command at the prompt to 
download and install the modules: 


pip install requests feedparser 


Get your API key 

An API (application programming interface) 
enables applications to talk to each other. In 
our case, we want our Python program to talk 
to OpenWeather. The service gives you up toa 
million requests per month for free, but you need 
to register for an API key so they can monitor your 
usage. Visit openweathermap.org/price and click 
‘Get API key’ in the free tier. You’ll need to register 
a username, email address, and password, and 
accept the terms. When you sign into your account, 
go to your API keys and copy your key. 


View your weather feed 

You'll use a specially formatted URL to fetch 
the weather. There are lots of different weather 
forecast options, but we’ll keep it simple by 
looking up the current weather. Let’s preview the 
data feed before we try to use it from Python. Ina 
browser window, enter the following URL. 


http://api.openweathermap.org/data/2.5/ 
weather?q=London,uk&units=metric&APPID 
=YOUR_API_KEY 


Change the city name to your own, and add 
your API key after the equals sign at the end. (If 
you’re not near a city, consult the documentation 
at openweathermap.org/current for tips on using 
longitude and latitude instead. ) 


The program downloads the 
news and weather. What you 


do with it next is up to you! 


Beautify the output 

When you view the feed in your 
browser, the code isn’t formatted for easy 
reading. It’s much easier to understand the 
incoming data if we reformat it. Copy the code, 
visit magpi.cc/beautifier, and paste the code in 
the box on the left. Click Format, and the box on 
the right will show a nicely formatted version 
of your code. The code is in JSON format, which 
behaves a bit like a Python dictionary. You use 
keywords to access the data associated with them. 
For example, the keyword ‘temp’ returns a number 
(measured in Celsius). The keyword ‘description’ 
gives me ‘clear sky’ today. 


Build the weather report 

The get_weather() function in 
rr_newsreader.py builds a weather report, which 
is returned as a string. The function also returns 
the temperature as a number, so you can use it 
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The Display-O-Tron 
has a 3x16 character 
display, ideal for 
short news headlines 


on numeric displays. First, the function uses the 
requests module to download your weather report. 
Then it uses the built-in JSON processor in the 
requests module to extract useful bits of it. 
Ultimately, Raspberry Radio will read out the 


M It's easiest to understand 
the code if you look at the 
JSON file 


weather report, so the report starts with a random 
phrase to add variety. It’s easiest to understand the 
code if you look at the JSON file (see Step 4) at the 
same time. The data variable stores our full report. 
We use data. json().get('weather') to access 

the weather attribute of it. The weather section 
contains an array with one item in it, which we 
access using [@] on line 19. Inside that array, we 
can find the description attribute. Similarly, we use 


TopTip & 


Extend the 
weather report 


As Step 4 shows, 
there's more 
weather data 
available. Modify 
the program 

to report on 
humidity, wind 
speed, and what 
the temperature 
feels like. 
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A You can use 
rr_newsreader.py 
to show the outside 
temperature ona 
Rainbow HAT, here 
shown through a 
diffuser layer 


news_output.py 


the attribute ‘main’ to access a subset of data that 
includes the ‘temp’. 


Use f-strings for formatting 
Line 23 uses a Python f-string to format 
the weather report. It’s an easy way to insert a 


> Language: Python 


McManus 
ee@3. 


Q@01. # News display for Displayotron HAT 
Q02. # From Raspberry Radio project in The MagPi by Sean 


ee04. import rr_newsreader 

@@5. weather_report, temperature = rr_newsreader.get_weather() 
@@6. print(weather_report) 

@0@7. date_report = rr_newsreader.get_date() 

@@8. print(date_report) 

@@9. news_report = rr_newsreader.get_news() 

@1@. for line in news_report: 

e11. print(line) 
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variable’s value into a string. You put an f before 
the opening quote of the string, and then put the 
variable name in curly braces inside the string. 
F-strings are more readable than alternatives, 
such as percentage formatting and the format() 
function. They both put a placeholder in the string 
and the associated variable after the string. 


07 Get an RSS link 

Many publications publish RSS feeds, 
but they’re not as prominent on websites as 
they used to be. You can often uncover them by 
Google searching for your favourite publication’s 
name plus ‘RSS’. The BBC publishes news 
feeds (magpi.cc/bbcfeeds) for topics including 
technology, health, and entertainment, as well as 
news feeds dedicated to the different geographies. 
The Guardian (magpi.cc/guardianfeeds) has 
feeds for a huge number of topics, as diverse 
as Agatha Christie, the Vietnam War, and Pink 
Floyd. Raspberry Radio works best if you pick a 
newsy topic that is fast-moving. We’re looking for 
headlines that make sense in isolation, so avoid 
feeds promoting feature articles. 


Get the news 

In rr_newsreader.py, the get_news() 
function uses the feedparser module to process the 
RSS feed. Paste the web address of your chosen RSS 
feed into line 30, or leave the code unchanged for 
The Guardian’s news headlines. The function builds 
a list called news_list. The first list item introduces 
the news, before the loop extracts the titles from 
the first three stories in the RSS feed, and adds 
them (appends them) to the list. The title contains 
the headline, and it’s all we need for our purposes. 
Each story also has a description (a summary, 
sometimes quite long), and a link to the main 
article. To find the URL for the article at index 2, for 
example, you’d use rss_feed.entries[2]. link. 


Get the date 

Newsreaders start their broadcast with the 
date, so the get_date() function creates a human- 
readable date. It uses the datetime module, and 
its strftime() function, which creates a string 
by extracting parts of the date. You use codes to 
specify the format you want to use. %A gets you 


the day name (e.g. Sunday), %d extracts the day 
number, and %B gives you the month in full. We’re 
using an f-string again here to build a string that 
combines those three date elements. There’s a list 
of codes at strftime.org. If you used %1, %M, and %p, 
you would get the time in the format ‘10 25 AM’. 


Prepare to import 

You might have noticed that 
rr_newsreader.py does not have any output. It 
defines three functions, but they’re not called at 
any time, and the information they gather isn’t 
displayed. That’s because we want to make this 
code reusable across different projects. This issue, 
you’ll see how to display the news headlines on an 
LCD screen, but next issue your device will read 


m™ We want to make this 
code reusable across 
different projects 


them aloud. We can import rr_newsreader.py 

into another Python program, as long as both 
programs are in the same folder. We used the name 
rr_newsreader.py to reduce the risk of confusion 
with other newsreader modules. 


Test the newsreader 

The news_output.py listing shows how to 
import rr_newsreader.py and access the current 
date, weather, and news headlines using it. The 
weather and date are returned as strings. The 
news is a list, so a loop is used to print each line 
in turn. You can use this program as a model for 
collecting the data so you can output it using your 
favourite HAT. 


Create your newsreader gadget 

The displayotron_news.py listing outputs 
the headlines on a Pimoroni Display-O-Tron. 
This is just a simple demo: headlines that are 
too long are shortened to fit the display. You 
could extend the program so it shows the full 
headlines and enables you to page through them 
using the buttons on the HAT. The program uses 


i cz 


basic animation, displaying each headline one 
character at a time, and brightening the LEDs 
when the headline is complete. It makes it feel 
like the news is coming in right now, and is more 
visually interesting than just having it pop up on 
the screen. {7 
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4 You can display the 
news in the Python 
shell, as shown here, or 
use rr_newsreader.py 
to download it and 
show it on your 
favourite HAT 
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Humanise the 
news 


You could adda 
randomly chosen 
introduction to the 
news to increase 
variety, as we have 
for the weather. 


displayotron_news.py 


> Language: Python 


@01. # News display for Displayotron HAT 


Q02. # From Raspberry Radio project in The MagPi by Sean 


McManus 
ee3. 
004. import rr_newsreader 
005. import time 
006. import dot3k.backlight as backlight 
007. import dot3k.1cd as lcd 


008. 

@@9. def display_text(text): 

e10. backlight.rgb(200, 200, 255) 
e11. for i in range(min(len(text), 48)): 
@12. substring = text[:i+1] 
013. lcd.clear() 

e14. lcd.write(substring) 
15. time.sleep(@.1) 

16. backlight.rgb(255, 255, 255) 
017. time.sleep(3) 

018. 


@19. date_report = rr_newsreader.get_date() 


@20. display _text(date_report) 
e021. 


@22. nmews_report = rr_newsreader.get_news() 


@23. for line in news_report: 
@24. display_text(line) 
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rr_newsreader.py THE FULL CODE: 


> Language: Python y) magpi.cc/newsreader 


Q@@1. # rr_newsreader generates news, weather, and date reports 
@@2. # From Raspberry Radio project in The MagPi by Sean McManus 
ee3. 

004. import feedparser 

@@5. import requests 

Q@6. import random 

007. from datetime import datetime 


008. 

@@9. def get_weather(): 

e1e. data = requests.get( 

@11. "http: //api.openweathermap.org/data/2.5/weather ?q=London, uk&units=metric&APPID=YOUR_API_KEY") 
@12. if data.status_code == 200: 

Q13. report = random.choice(["The weather today is ", 

e14. "We're looking at ", 

e15. "Today, expect " 

016. "There's going to be " 

Q17. "Out and about today, you'll see "]) 
e18. weather_forecast = data. json().get( ‘weather’ ) 

@19. description = weather_forecast[0@].get( ‘description’ ) 

20. report += description 

21. main = data.json().get('‘main') 

@22. temperature = main.get('temp') 

23. report += f". The temperature is {temperature} Celcius." 
024. return report, temperature 

@25. else: 

026. return "There is no weather report today.", False 

@27. 

@28. def get_news(): 

@29. news_list = [] 

30. rss_feed = feedparser.parse('https://www.theguardian.com/uk-news/rss') 
31. news_list.append("Here's the news from The Guardian.") 

@32. for i in range(3): 

@33. news_list.append(rss_feed.entries[i].title) 

34. return news_list 

@35. 

@36. def get_date(): 

037. date = datetime.today() 

038. date_text = f"It's {date.strftime('%A')} {date.strftime('%d')} {date.strftime('%B')}." 
39. return date_text 
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The same PCB is 
used for both left 


and right wing 
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In the workshop: Sublimation printing 


sublimation printer looks and 

works a lot like an ordinary 

inkjet printer. You load paper into 

it (although it does have to be 

proper sublimation paper), plug it 

into your computer, and press 
print. So far, so ordinary. 

The word sublimation means to turn from a solid 
into a gas without being a liquid in between. This 
stage — the sublimation — is what happens after 
you've printed onto paper. It means you can turn 
the, now solid, ink into gas and transfer it onto 
other objects. 

When we say other objects — there’s a wide range 
of stuff that you can transfer sublimation prints 
onto, but not everything. It has to have a coating 
that will accept the ink. In most cases, this means 
buying a pre-prepared ‘blank’, although you can get 
laminates and varnishes that will let you coat the 
surface yourself. 

Once you have the printed sheet and the object to 
impress the image on, you just need to stick the 
paper on with heat-resistant tape (aka Kapton tape), 
and heat-press it on. This is another limitation on the 


range of objects that you can transfer images onto 
— you have to be able to heat-press them. 

For flat surfaces, it's pretty easy with a standard 
heat-press. You can also get cylindrical presses for 
mugs. Beyond that, it’s a bit challenging. For industrial 
uses, you can get heat-presses that can make custom 
shapes, but that’s probably a little excessive for 
hobbyist use. 

You have to be able to heat the whole lot up to 
about 200°C, so it’s not ridiculously high 
temperatures. We have heard of people having 
success using convection ovens and heat-shrink to 
hold the designs in place, but we've not tried this, 
and it’s probably best not to do it in an oven that's 

Below & 
also used for food. A bit of Kapton tape 
We've been testing out a range of different ‘ holdS*the, REBsiin 


- s 7 place while | heat- 
materials and blanks. Mugs, jigsaws, photo-slates, > press on the image 


Left ¢ 

Plain white 
silkscreen covers the 
whole of the PCB 


ie mits EP Sains. A 
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I’ve made mugs for 
our sister magazines 
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In the workshop: Sublimation printing 


(slates with a flat side that has a layer of sublimation- 
friendly coating), and fabric. 

It's helpful to me if a process is a little tricky or has 
a few gotchas. This gives me something to write 
about in the article. The problem is, everything went 
very smoothly. In fact, the only problem we had in the 
whole process was a mug heat-press that just kept 
beeping at us, but reading the manual and working 
out what button to press sorted that out. 

Different materials require slightly different 
emperatures, and can require radically different 
imes. As far as | can tell, heavy things like ceramics 
hat take a long time to heat up require longer than 
ighter things, like jigsaw blanks. However, you should 
be able to get the right time from wherever you get 
your blanks, if not, you'll just have to experiment for a 
bit. About 60 seconds at 190°C was the quickest we 


 <—! 


did (jigsaws), and 240 seconds at 205°C was the 
longest (slate blanks). If you get a sepia tint, leaving 
your images looking like they are a few hundred years 
old, then you've probably overheated the ink. 

As a final test, we tried sublimating ink onto a PCB, 
just to see what happens. The initial results were 
really good. While the ink did not have a great deal of 
effect on the FR4, it stuck extremely well to 
silk-screened areas. 

This meant that we couldn't just sublimate print 
onto any PCB we wanted - we had to design specific 
PCBs covered in silkscreen to take the ink. I've 
always wanted to make a butterfly PCB. Long-term 
readers with a very good memory may remember 
that HackSpace mag, issue 1, featured a butterfly 
PCB from the now-defunct Boldport Club. In that, 
they'd used two different silkscreen colours to create 
the decorative effect but, in mine, | could just print 
whatever | wanted. 

This was just a test, so | wanted something that 
would look good, but not take too long to design. | 
settled for a circuit that linked up three through-hole 
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Left 

The butterfly’s 
LEDs can light up 
any colour 


RGB LEDs. The design was one wing, but | could just 
flip it over to create the other wing. 

These came back a week or so later, and it was 
time to try them out. | didn't have a specific pattern in 
mind (this was still a test, so | didn't want to spend 
ages on it before knowing if it'd work), so | printed off 
a swirling colour image that | found online, stuck a 
couple of wings to it, crossed my fingers, and started 
the heat-press. 

The result isn’t quite perfect. The image doesn't 
quite have the detail that I’ve been able to get on 
some surfaces. |’m not yet sure if that’s a result 
of the inherent properties of the silkscreen, or if | 
just haven't yet dialled in the settings (the PCBs 
only arrived a few days before we went to press, 
so | haven't been able to properly test the process 
out yet). So far, it seems like the ink is very prone 
to overheating with PCBs. The best results that | 
have had are at 180°C for 60 seconds, but it’s still 
early days. 

This is definitely a ripe area for experimentation if 
you're interested in making artistic PCBs. a 


HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc. 
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Learn ARM 
assembly: blink 
Picos on-board 
LED using the 
Programmable I/O 


Learn how to use the Programmable |/0 (PIO) processors 
on the Raspberry Pi Pico in their native assembly 


language to blink the on-board LED 


with the ARM CPU, like we did in the 

previous tutorial (see The MagPi issue 
#120, magpi.cc/120), uses a lot of processing 
power that you might need for higher-level 
tasks. The Raspberry Pi Pico contains eight PIO 
processors that you can use to offload I/O related 
processing. In this tutorial, we will blink the 
Raspberry Pi Pico’s on-board LED. The program 
downloads a small assembly language program 
to one of the PIO processors which will then do 
all the work of blinking the LED, letting the main 
ARM CPU proceed to perform other tasks. 

The PIO processors operate on their own 

assembly language, which is quite different 
from ARM assembly language. This assembly 
language only contains nine instructions, and the 
maximum program Size is 32 instructions, but 
even with these limitations, PIO can perform quite 
powerful I/O operations. There are five registers: 
two general-purpose registers, two shift registers 
for data transfer, and the program counter. 


D irectly controlling hardware devices 


Create the program 

Create a folder named tutorial6 in the 
pico folder that was created in your home folder 
by the Raspberry Pi Pico SDK’s setup script. 
The source code for this tutorial is in blink.c, 
blink.pio and CMakeLists.txt. Copy the file 
pico_sdk_import.cmake from the SDKk’s external 
folder to the tutorial6 folder. In this folder create 
a new folder called build. The tutorial6 folder 
should now look like: 


pi@raspberrypi:~/pico/tutorial6 $ 1s -1 

total 20 

-rw-r--r-- 1 pi pi 972 Jun 25 11:22 blink.c 

-rw-r--r-- 1 pi pi 925 Jun 25 11:17 blink. 
pio 

drwxr-xr-x 7 pi pi 4096 Jun 25 11:22 build 

-rw-r--r-- 1 pi pi 698 Nov 5 2021 
CMakeLists.txt 

-rw-r--r-- 1 pi pi 2763 Apr 9 09:15 pico_ 
sdk_import.cmake 
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Build the program 

These steps are identical to those in 
tutorial 5. The difference is that the CMakeLists.txt 
file adds includes a pio file containing PIO assembly 
language rather than the usual .s ARM assembly 
language file. Open a Terminal window and cd to 
the tutorial6 folder. 


cd pico/tutorial6/build 
Run cmake with the option to perform a debug 
build. Placing this command in a script file in the 


SHOME/bin folder with a short filename can be a 
real time-saver. 


cmake -DCMAKE_BUILD_TYPE=Debug .. 
The cmake command doesn’t build the program 
— instead, it creates a makefile used to compile by 
running make: 


make 


The build folder should now look like the 
example below: 


pi@raspberrypi:~/pico/tutorial6/build $ 1s 
-1 


total 1192 

-rw-r--r-- 1 pi pi 1856 Jun 25 11:19 
blink.pio.h 

-rw-r--r-- 1 pi pi 18815 Jun 15 13:30 
CMakeCache. txt 

drwxr-xr-x 7 pi pi 4096 Jun 25 11:22 
CMakeFiles 

-rw-r--r-- 1 pi pi 1670 Jun 15 13:30 
cmake_install.cmake 

drwxr-xr-x 6 pi pi 4096 Jun 15 13:30 
elf2uf2 

drwxr-xr-x 3 pi pi 4096 Jun 15 13:30 
generated 

-rpw-r--r-- 1 pi pi 77139 Jun 15 13:30 
Makefile 

drwxr-xr-x 6 pi pi 4096 Jun 15 13:30 pico- 
sdk 

drwxr-xr-x 5 pi pi 4096 Jun 15 13:31 
pioasm 

-rwxr-xr-xX 1 pi pi 22652 Jun 25 11:22 pio_ 
blink. bin 

-rw-r--r-- 1 pi pi 364370 Jun 25 11:22 pio_ 
blink.dis 

-rwxr-xr-x 1 pi pi 351404 Jun 25 11:22 pio_ 
blink.elf 

-rw-r--r-- 1 pi pi 234360 Jun 25 11:22 pio_ 


SNSETESE SES Eee een 


soetaers 


blink.c souce code 
in the Geany IDE 


blink.elf.map 
-rw-r--r-- 1 pi pi 
blink. hex 
-rw-r--r-- 1 pi pi 
blink.uf2 


63776 Jun 25 11:22 pio_ 


45568 Jun 25 11:22 pio_ 


Run the program 

Power on Raspberry Pi Pico by plugging the 
USB cable into the power connector while holding 
down the BOOTSEL button. When the file explorer 
window appears, open it, and copy the file pio_ 
blink.uf2 to the Pico. Your Pico reboots, then the 
program runs. The program prints out information 
on how fast the LED is blinking and which iteration 
of the loop it is on. Open a serial port program to 
see this output. 


™ PIO can perform quite 
powerful I/O operations 


minicom -b 1152@@ -o -D /dev/serial@ 


The minicom command displays data being sent 
from the Pico to Raspberry Pi (Figure 1). 


About compiling the PIO module 

In previous tutorials, the GNU Assembler 
compiled our assembly language files into object 
modules that were linked into the program’s 
executable file, which would be run directly by 
the operating system. The PIO code needs to be 
separately downloaded to the PIO program memory 
via Raspberry Pi Pico’s SDK. The PIO assembler 
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PIO assembly language 
code to blink the LED 
in the Geany IDE 


| You'll Need 


» Raspberry P 


> Raspberry Pi Pico 
» Serial and debug 
connector wires 
» Raspberry Pi OS 
32-bit 


» Raspberry Pi Pico 


SDK 
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> Figure 1 Running 
the program and 
observing the 
output in minicom 


compiles blink. pio into blink.pio.h, which is 
a standard C header file. This file contains an 
array of 16-bit numbers that are the compiled 
values of the program: 


static const uint16_t blink_program_ 
instructions[] = { 


@x8@a@, // @: pull block 


CMakeLists.txt 


» Language: CMake 


ee1. 
0e2. 
003. 
e004. 
0e@5. 
006. 
007. 
008. 
ee9. 
18. 
11. 
Q12. 
013. 
014. 


Q15. 


16. 


17. 
18. 
19. 
20. 


21. 


cmake_minimum_required(VERSION 3.13) 


include(pico_sdk_import.cmake) 
project(test_project C CXX ASM) 


set(CMAKE_C_STANDARD 11) 
set (CMAKE_CXX_STANDARD 17) 


pico_sdk_init() 
add_executable(pio_blink) 


# by default the header is generated into the build dir 
pico_generate_pio_header( 

pio_blink ${CMAKE_CURRENT_LIST_DIR}/blink. pio) 

# however, alternatively you can choose to generate it 
somewhere else (in this case in the source tree for check 
in) 

#pico_generate_pio_header(pio_blink ${CMAKE_CURRENT_LIST_ 
DIR}/blink.pio OUTPUT_DIR ${CMAKE_CURRENT_LIST_DIR}) 


target_sources(pio_blink PRIVATE blink.c) 
target_link_libraries(pio_blink PRIVATE pico_stdlib 


hardware_pio) 
pico_add_extra_outputs(pio_blink) 


3 


@x6040, // 1: out 

Hf -wra 
Q@xa@22, // 2: mov 
Q@xee@e1, // 3: set 
@xee044, // 4: jmp 
Q@xa@22, // 5: mov 
@xee@ee, // 6: set 
@x0@047, // 7: jmp 
@xa@22, // 8: mov 

Hii .wra 


y, 32 
p_target 


xX, ¥ 
pins, 1 


p 


The header file includes several helper functions 
to set various configuration parameters. The 
program is downloaded via the pio_add_program SDK 
function called from the main() function in blink.c. 


How the PIO assembly 
language works 
In all the previous tutorials, we studied how the 
program works by single-stepping through it in 
the gdb debugger. As of this 


an open-source d 
language. This tu 
instructions. To get a fee 
let’s walk through these 


The f 


writing, there isn’t 


ebugger for the PIO assembly 
torial program contains just eight 
for PIO programming, 
instructions. 


irst thing the program does is receive the 
count for a delay loop from t 
running on the ARM CPU. It 
to do this: 

* pull block — moves 32 bits of data from the 


he main program 
takes two instructions 


transmit FIFO to the PIO’s Output Shift Register 
(OSR). The FIFO is transmit, since data is 
transmitted from the ARM CPU. 


* out y, 32- transfers 32 bits from the OSR to 


instruc 
For ins 
-Wrap a 


nstruc 
hat let 
which i 
to have 


tea 


tions — several are se 


re for configuration. 


you configure when 


one infinite loop wit 


the valuable 32 assembly ins 
the loop. 


the general-purpose Y register. 
Not all operations on the PIO are performed via 


t by configuration. 


tance, the statements .wrap_target and 


f the program counter 


PC) passes instruction 31, then it wraps back to 
tion 0. However, there are control registers 


the PC will wrap and 


nstruction it will wrap to. This allows you 


hout using one of 
tructions to perform 


The mov instruction is stra 
the delay loop count is move 


register, ready to be counted 


The set instructio 


ightforward: here, 
d from the Y to the X 
down. 


n is used to set the configured 


GPIO pins either high or low. First, it is set high 
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to turn the LED on. The actual pin affected is 
controlled by a configuration register. 

The jmp instruction does several things. It is the 
only PIO instruction that performs arithmetic, and 
the only arithmetic it can perform is subtracting 
one. It provides conditional logic that will jump 
so long as the register, in this case xX, is non-zero. 
Once X is zero, it falls through. The conditional 
logic can be reversed by placing a ! in front of the 
register. The purpose of the jmp statements in this 
program is to provide a delay so the LED flashes 
at a rate a human can perceive rather than at the 
speed of the Raspberry Pi Pico’s 125MHz clock. 


™ Normally, each instruction 
takes one clock cycle @ 


These instructions then repeat, turning the LED 
off and performing the same delay loop to result in 
an even blinking. 


Varying the timing 

The primary design goal of the PIO 
processors is to handle the lower-level details of 
various communications protocols, which involves 
switching GPIO pins between high and low at high 
speeds subject to precise timing. The PIO offers 
quite a few features to assist in this. For instance, 
each instruction can have an extra parameter that 
provides up to five bits telling it how many clock 
cycles to take. Normally, each instruction takes 
one clock cycle. But, for instance: 


mov x,y [31] 


...will take 32 clock cycles to execute: one to 
perform the move, then 31 extra cycles fora 
total of 32. 

This tutorial uses the PIO’s clock divider to 
vary the speed at which the LED blinks. The 
clock divider has a 1/256 precision, so its value is 
provided as a floating-point number to the SDK, 
then the SDK converts that into the value required 
by the PIO control register. We set the clock divider 
in the blink_program_init routine in blink.pio via: 


sm_config_set_clkdiv(&c, clkdiv); 


To change the value, the PIO is reconfigured 
every ten seconds from the main C file. 
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blink.pio 


> Language: PIO Assembly Language 


ee1. 
002. 
003. 
e004. 
Qe@5. 
006. 
007. 
008. 
ee9. 
010. 
011. 
Q12. 
Q13. 
14. 


Q15. 
016. 
Q17. 
18. 


19. 
20. 
21. 
Q22. 
23. 
Q24. 


25. 
26. 


Q27. 
028. 
@29. 


030. 
Q31. 
Q32. 
Q33. 
Q34. 


5; Program to blink a LED 


3; SET pin @ should be mapped to your LED GPIO 


-program blink 

pull block 

out y, 32 
-wrap_target 

mov x, y 

set pins, 1 $ 
1p1: 

jmp x-- lpi; 
bit number 


Turn LED on 
Delay for (x + 1) cycles, x a 32 


mov x, y 
set pins, @ ; 
lp2: 
jmp x-- 1lp2_ ; 
again 
mov x, y 
-wrap ; 


Turn LED off 


Delay for the same number of cycles 


Blink forever! 


% c-sdk { 

// this is a raw helper function for use by the user 
which sets up the GPIO output, configures the SM to 
output on a particular pin 


void blink_program_init( 

PIO pio, uint sm, uint offset, uint pin, float clkdiv) { 
pio_gpio_init(pio, pin); 
pio_sm_set_consecutive_pindirs(pio, sm, pin, 1, true); 
pio_sm_config c = 

blink_program_get_default_config(offset) ; 
sm_config set_clkdiv(&c, clkdiv); 
sm_config set_set_pins(&c, pin, 1); 
pio_sm_init(pio, sm, offset, &c); 

} 

we} 


07 


The main C program 

The main C program initialises the PIO and 
lets it do its job. The program can start the LED 
blinking and then go on to do other processing 
without having to worry about the LED ever 
again. This is the goal of offloading low-level I/O 
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DOWNLOAD 
THE FULL CODE: 


operations to the PIO, freeing up the ARM CPUs b | in kc 
to perform other useful work. In this case, after 
initialising the PIO, the C program executes a loop 
where every ten seconds it re-initialises the PIO 
with a different timing value based on the index 


y) magpi.cc/learnassembly6 


» Language: C 


it counts. ee1. /** 
Raspberry Pi’s SDK examples contain 19 PIO @@2. * C Program to set the PIO in motion blinking the LEDs 
sample programs. The best way to write a PIO 003. */ 
program is to use one of these as a starting point, 004. 
if there isn’t already one that meets your needs. @@5. #include <stdio.h> 
Then refer to the ‘Raspberry Pi Pico C/C++SDk’ and 006. 
‘RP2040 Datasheet’ manuals for the various SDK 007. #include "pico/stdlib.h" 
functions that control the PIO, and for details on 008. #include "hardware/pio.h" 
PIO assembly language. @09. #include “hardware/clocks.h" 
610. #include "blink.pio.h" 
011. 
@12. const uint LED_PIN = 25; 
Modify the program Q13. 
Congratulations! Welcome to the world @14. void blink_pin_forever(PIO pio, uint sm, uint offset, 
of PIO programming for Raspberry Pi Pico (and uint pin, uint freq, float clkdiv); 
any other board using Raspberry’s RP2040 e15. 
chip). Without debugging or print statements, 016. int main() { 
developing PIO programs can be tricky. The best 017. int i = 0; 
way is to start simple, such as taking a working e18. 
program like this one and modifying it to change 019. setup_default_uart(); 
its functionality. Then, as long as you take small e2e. 
steps, when something breaks, you will know what e21. PIO pio = pio; 
did it and you can go back to a working state. Try @22. uint offset = pio_add_program(pio, &blink_program) ; 
experimenting with the timing of the LED pattern, @23. printf("Loaded program at %d\n", offset); 
perhaps have it do a longer flash followed by a e24. 
shorter flash. Can you think of a way to expand @25. while(1) 
this to transmit Morse code? fl @26. { 
027. i++; 
@28. blink_pin_forever(pio, @, offset, LED PIN, 10, ( 
Stephen's stuff mae 
@29. printf("Busy counting away i = %d\n", i); 
30. sleep_ms(100@@) ; 
He's written three books 31. } 
on Mss Language @32. } 
Programming. The most 033. 


recent one is RP2040 
Assembly Language 
Programming for the 


@34. void blink_pin_forever(PIO pio, uint sm, uint offset, 
uint pin, uint freq, float clkdiv) { 


Raspberry Pi Pico, which is the @35. blink _program_init(pio, sm, offset, pin, clkdiv); 
place to go for a deeper @36. pio_sm_set_enabled(pio, sm, true); 

understanding of the topics 037 

touched on in this tutorial. The first 038. printf("Blinking pin %d at %f Hz\n", pin, 


one is Raspberry Pi Assembly : 
Language Programming for 32-bit freq / clkdiv); 

ARM code, and the second 039. pio->txf[sm] = clock_get_hz(clk_sys) / freq; 
is Programming with 64-Bit ARM Assembly Language. e040. } 
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Build a robot: 
add sensors to 
the chassis 


Last month, we started our build of the CamJam Robotics Edukit. 
Now we have a roving robot, it's time to add some smarts! 


PJ Evans f you followed last month’s tutorial, you 
ae je should now have a working robot that you 
ar aURE can control with Python. Hopefully, you’ve boananit 
software engineer ; ; 
and tinkerer. His played with the code and had the little ‘bot’ 
robots bring all the zooming around the place. Now it’s time to add spt tes 
eee 
i some sensors, so our new pal can start to sense 
twitter.com/ the world around it. With the ultrasonic and light 


mupyevens sensors included with the CamJam EduKit #3, we 


can add some autonomous capabilities and make 
our robot a little smarter. Finally, we can look at 
what you can do to improve the robot even more 
with custom chassis and additional sensors. 


eeeee 
eeeee 
eeeee 
eeeee 
eeeee 
eeeee 
eeeee 


Get sensitive 
Included with your CamJam kit is a light 
sensor. It works by sending out infrared light 
(that we can’t see) and detecting how much of 


it bounces back to a sensor. If we point it at the ial 

ground and measure the sensor’s output, we °;* 

can easily tell when the robot passes over a line. o/s 

The key to success is high contrast, so a jet black e;9 

line on a white surface is perfect. We’re going to ee 

mount the sensor on the front of the robot, point ee 

down, so we can detect a line. ee 

[ You'll Need ge 

- 

>» CamJam Edukit #3 e 

~ Robotics 02) A little light wiring e 

maypl-ec/adukits To wire up the light sensor, we’re going to ° 

» Printer use the breadboard (the small block with lots of e 

> Roll of paper holes). Holding it with the longer edge horizontal, 

(optional each column of holes are connected together, A Figure 1 Wire up the line sensor to the HAT. 
witha gap in the centre. Breadboards allow us Use the breadboard to create a ‘ground rail’ 


64 | magpicc | Build a robot: add sensors to the chassis 


This tiny sensor bounces light 
from a transmitter to a receiver. 
It can detect lines through a 
sudden drop in reflected light 


to connect circuits together without soldering, 

so we can quickly prototype circuits and correct 
mistakes. You’ll need three wires: two plug-to- 
socket, and one plug-to-plug. Wire everything 
together as shown in the diagram, checking and 
double-checking. There are three connectors on 
the light sensor for power, grounding, and data. 
These all need to match up with the connector on 
the robot HAT connected to your Raspberry Pi. 


Mount the sensor 

The sensor needs to be in a sensible place 
on the box chassis, and that would be in the centre 
at the front on the base. However, this is also the 
highest point of the body, and the further away 
the sensor is from the ground, the less accurate it 
will become as ambient light leaks into the sensor. 
Start by making a hole off-centre towards the front 
of the chassis and feeding the three wires through 
it. Connect the wires to the sensor as shown in 
Figure 1, then mount the sensor to the body with 
sticky pads. You may find a couple of LEGO bricks 
will sufficiently lower the sensor to the ground. 


MaigPi 


By measuring how long 
it takes to receive an 
ultrasound echo from 
the transmitter, we can 
calculate how far the 
robot is from an obstacle 


Testing time 

The sensor will not work without a little 
code to help it on its way. Enter the code from the 
test_line.py listing, overleaf (or download it from 
the GitHub repo: magpi.cc/testlinepy), and save 
it in your home directory as test_line.py. Now run 
the code: 


python3 test_line.py 


Don’t worry, your robot won’t move at this point. Top TI p 

What we want to do is check the sensor is working 

correctly. Using a sheet of paper with a thick Safety First 

black line through it (magpi.cc/testlinepdf), hold 

your robot carefully and pass the paper under the Whenever 
connecting 


sensor. If all is working well, you’ll see messages 


. wires to your 
on-screen that the line has been detected. 7 


Raspberry Pi 
computer, ensure 
it is completely 
powered-down. 


Follow that line A mistake when 
Now our little pal can detect a line, we can the computer 
make them follow it too! By combining code to ena 
drive the robot forward and steer it left and right, damage. 
we can make corrections as we go. This listing is a 


Build a robot: add sensors to the chassis magpi.cc 65 


WE Magri | TUTORIAL 


A Here is the wiring 
on the line sensor. 
The lower the sensor 


can be mounted 
to the ground, the 
more accurate the 
result will be 


TopTip & 


Colourful 
resistors 


Resistors are 
identified by 
coloured stripes 
on their body 
and can be 

used either way 
around. The 4700 
resistor is Yellow, 
Violet, Black, 
Black, Brown; the 
330 Q is Orange, 
Orange, Black, 
Black, Brown. 


CamJam Edukit #3 


Robotics 


little longer, so download it to your home directory 
from magpi.cc/linefollowerpy and try it out. Place 
your robot at the start of the line and then run: 


python3 line_follower.py 


Hopefully, your roving friend will scoot along the 
length of the page. Do you notice how it’s slower 
and more controlled? We’re using pulse-width 
modulation (PWM) to slow the motors down. 
You can play with the setting by changing the 
leftmotorspeed and rightmotorspeed variables. 


Make a course, of course 

OK, so our new friend can follow a line. How 
about an entire course? If you’ve got access to a big 
roll of white paper, try mapping out a course for 
the robot to follow. If not, you could stick pieces 
of A4 paper together. Make it as big as you can, 
without any tight corners to which the robot may 
not be able to respond. Use a pen such as a Sharpie 
to create the line to follow, and make it nice and 
thick, like the one on the printout. Now watch as 
your newly smarter robot follows the line in circles. 


07 Looking into the distance 
If we want our robot to be able to move 
around a room on its own, there’s a significant 
problem: walls. Our final modification is to adda 
distance sensor to the robot, so it can take avoiding 
action when it gets close to an obstacle. The sensor 
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works by transmitting an ultrasonic pulse and 
detecting when it is returned. With a bit of maths, 
we can use the time taken (‘time of flight’) to 
calculate how far away the obstacle is from the 
robot. The wiring is a little more complicated for 
this as the sensor needs 5 V to work, but must 
only return a 3.3V signal to avoid damaging your 
Raspberry Pi 4. 


Wiring up for safe voltage 

Study the Figure 2 wiring diagram carefully. 
Mount the sensor to the breadboard along the long 
edge, so each connector has its own column (or 
‘rail’). Move the two existing ground connectors 
for the line sensor so they are on the same rail 
as the GND pin for the distance sensor. Connect 
TRIG to #17 on the CamJam HAT. Finally create a 
‘voltage divider’ to reduce the return voltage to 
3.3V. Do this by adding the supplied 470 resistor 
to bridge the GND rail to any spare rail. Now add 
the 330 Q resistor to bridge that spare rail to ECHO. 
Finally, link the the spare rail to #18 on the HAT. 


DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/testlinepy 


test_line.py 


» Language: Python 3 


001. import time 

002. from gpiozero import LineSensor 

ee@3. 

004. # Set variables for the GPIO pins 
Q@5. pinLineFollower = 25 

@@6. sensor = LineSensor(pinLineFollower) 
007. 

@@8. def lineseen(): 


ee9. print("Line seen") 
010. def linenotseen(): 

e11. print("No line seen") 
Q12. 


Q13. # Tell the program what to do with a 
line is (un)seen 

@14. sensor.when_line = lineseen 

@15. sensor.when_no_line = linenotseen 


016. 

017. # Repeat the next indented block 
forever 

@18. while True: 

e19. time.sleep(10) 


Receiver Echo Transmitter 
Trig 


To line sensor VCC 


Mv, eee eevee erpe 


CamJjam Edukit3 CamJam.me/edukit 


Facing forward 

To get an accurate reading, the ultrasonic 
sensor needs to be mounted facing forward in the 
centre. You may have to get a little creative to find 
the best way to attach the breadboard so it fits. 
We used a bit of double-sided sticky tape on the 
breadboard to hold in place, so the sensor sat over 
the edge of the box. A small cardboard or plastic 
box for the board to sit on would also work well. 
Another option is to remove the sensor from the 
breadboard altogether and use four jumper wires 
to reconnect it, allowing the breadboard to sit on 
the base. 


Testing from a distance 

Let’s create another test file. In your home 
directory, create a new file called test_distance.py 
and add the code from the listing here (or 
download it from magpi.cc/testdistancepy). As 
before, run this code from the command line: 


python3 test_distance.py 


Watch the output from the screen and move your 
hand towards the sensor. If everything is working, 
you’ll see measurements of the distance from your 
hand to the robot. This is calculated by taking the 
output from the sensor (the elapsed echo time 

in seconds), multiplying it by the speed of sound 
(34,326 cm per second) and then halving, as it has 
made an outward and return journey. 


You own autonomous robot 
Congratulations! Your robot build is now 
complete. Let’s combine all the parts of the robot 
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in one last Python program. It’s a bit long, so you 
can download it here: magpi.cc/avoidancepy. The 
code will move the robot forward until it detects 

an upcoming obstacle. It will then back off and 
turn right. It will then advance forward. If the 
obstacle is still in place (or a new one is found), it 
will repeat the process until the obstacle is cleared. 
These simple instructions will result in a robot that 
will happily trundle around the room until you stop 
it or the batteries wear out! 


4 Figure 2 Build this 
circuit to get readings 
from the distance 
sensor. Always triple- 
check everything 
before powering-up! 


Make it your own 

You are the proud custodian of a line- 
following, obstacle-detecting robot. The good 
news is, that’s not the end of your, or your robot’s, 
journey. Now you have the basic building blocks of 
code, try and make your robot do more. Could you 
add dynamic speed control based on distance from 
an obstacle? Are there other sensors you could 
add? How about 3D-printing Daniel Bull’s custom- 
designed chassis (magpi.cc/robotchassis)° Or, use 
this project as a starting point and design and build 
your own robot. Try replacing the CamJam HAT 
with a motor controller board and upgrading to 
four-wheel drive. Whatever you decide, have fun. 

Many thanks to Mike Horne and Tim Richardson 

of CamJam for their help sheets and code that 
informed this tutorial. 


DOWNLOAD 
THE FULL CODE: 


wy) magpi.cc/testdistancepy 


test_distance.py 


» Language: Python 3 


Q01. import time 

Q02. from gpiozero import DistanceSensor 

ee3. 

004. # Define GPIO pins to use on the Pi 

@0@5. pintrigger = 17 

Q@@6. pinecho = 18 

@@7. sensor = DistanceSensor(echo=pinecho, 
trigger=pintrigger) 

ee8. 

@09. # Check the distance every half a second 

@10. while True: 


@11. print("Distance: %.1f cm" % ( 
sensor.distance * 100)) 
@12. time.sleep(@.5) 
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Use Rasp berry Pi and Pico u alloween parties are great. When else 
ae do you have an excuse to eat unusual 
to power up your petrifying amounts of sweets while watching a 
é é marathon of The Simpsons episodes, and maybe 
party this Halloween with partaking of a beverage that is a) smoking and 
Ghost Host Rob Zwetsloot b) served out of a cauldron? 


This year, let’s make this a Halloween party 
to remember by performing some mad science 
with a Raspberry Pi or Raspberry Pi Pico to make 
everything a little more... eerie. 

You won’t need strikes of lightning for this, 
just some long USB leads and/or batteries. 

Let’s get spooky. 


ATROCIOUS ALTERNATE ARTICLES 


Spook up your Raspberry Pi 10 Spooktastic Halloween 
Costume Projects 
magpi.cc/86——_—=—— 


magpi.cc/110———=——| 


Make your existing Raspberry Pi projects 
seasonally spooky with this frightening feature. Dreadful dressing-up with this collection of 


chilling cosplays. 


Haunted House Hack 
magpi.cc/98—=— == 


A gruesome guide for making your home horrifying 
this Halloween. 
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Holiday light show 


While, yes, technically these are Christmas-themed lights, you just need 
to switch the light colours and music to make it truly Halloween-themed. 

It uses LightShow Pi, which is a popular library for syncing up music to 
programmable LEDs to make your whole setup seem in sync. We imagine 
it would look quite scary with the Monster Mash playing. 


=~ magpi.cc/holidaylights == 


A huge project full of outdoor Halloween 
decorations controlled online by people 
around the world might sound chaotic — and 
it is — however that’s also a big part of the 
Halloween spirit, surely? 

What started off as Christmas-themed 


lights was turned spooky for October. One 
credit to activate one thing was around 10¢ 
(8p). However, you don’t have to make yours 
pay-to-play. 


= magpi.cc/poplawski “= 


Gruesome garlands to meet your ghastly gue t 


- 
> 
. 


DIY Interactive __ 
Performing Pumpkins 


These 3D-printed pumpkins use projections to 


serenade you with some scary songs, and people 
passing by can even select different moods for the 
melodies. While this may sound like a bit of a weather 
hazard for the projector, this particular project allows 


you to keep it inside, safe from the elements. 


There’s a very detailed tutorial on the DIY Machines 
site, including wiring diagrams and code, etc. Pretty 
much any projector will do, with a little tweaking. 


={ magpi.cc/performingpumpkins —F 


machines 


Smart and Spooky Halloween Party! | magpi.cc | 69 


DANINED 


FEATURE | Might 


These beastly 
beverages are 

sure to go down 
g (trick or) treat 


Eyeball snot-tail 


This mix of lime jelly, apple 
and/or pear juice, lemonade, 
lychees, cherries, and raisins 
creates a light, tasty citrusy 
mocktail that also happens 
to look like it's eyes in 
nondescript green goop. 


magpi.cc/snottail 


Halloween punch 
This spiced and spicy cherry 
juice punch has a bit of a bite, 
and not just from the tangy, 
fangy sweets. 


magpi.cc/punch 


Mulled 
apple juice 

If you want to serve something 
a little more traditional 

and a little less gimmicky, 

this mulled apple juice is a 
great idea. 


magpi.cc/mulledapple 
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Dress to depress with these despicable duds 


Halloween voice changer 
RoscoP13 
Want to be really anonymous at your Halloween 
get-together? Then having a Raspberry Pi mask 
your voice on the fly is the way to go. This tutorial 
not only shows you how to do the software and 
electronic hardware, but also how to install it 
into a mask so you can actually wear it. 

With some modifications, you can give yourself 
a custom voice profile, whether you want to be 
Darth Vader or Bane. 


magpi.cc/voicechanger 
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Time Circuit and Flux Capacitor 
Carl Monk 
You could try and cosplay as a time-travelling Irish 
sports car if you have enough cardboard and room 
to manoeuvre. However, it’s a bit easier to cosplay 
as its inventor, with props from the car. These 
recreations use Raspberry Pi and seven-segment 
displays in a fun way that can be used for a lot of 
portable projects, and portable costumes. 

The web page has a detailed tutorial on how to 
build the time circuit and such, although you’ ll 
need to find your own Doc Brown outfit. 


magpi.cc/docbrown 
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FINGER FEAST 


Face-changing projection mask A brutal buffet 
Sean Hodgins . 

From the maker of the haunted Jack-in-the-box featuring both 
comes this incredible projection mask that uses sweet and (i) 


a small DLP projector hooked up to a Raspberry 


Pi connected via a stick. The projector sits in the You COULD savoury delights 


chin of the mask and uses projection mapping 
on specific videos so that they show up as they 


would on a screen. It’s a very clever mix of A LWAYS us 
hardware and software. ‘ 
Witches fingers 
magpi.cc/projectionmask THE TECH FOR This finger food is quite literally 


fingers... or at least breadsticks 
with a garlicky tang to them. 


$0 METHING FLSE magpi.cc/witchfingers 


= Dirt and worms 


_ Gummy worms buried in 
rd crumbled biscuits and 
* chocolate pudding? Spooky 
~ and delicious. 
» 


magpi.cc/dirtnworms 


Disco ball 
Wolfie 
No one will miss you at the party if you’re walking 
around with many strips of LEDs attached to your 
person. This one can work on its own, but you can 
also hook it up to your house’s light show if you 
want for some wonderful synchronised costuming. 
There’s lots of LEDs, chicken wire, foil, and some 
3D-printed parts to make this, although you could 
always use the tech for something else. 


magpi.cc/discoball 


Sausage 
mummies 


Cocktail sausages wrapped 
in spirals of puff pastry - add 
edible eyes or little dots of 
mustard to make them really 
stand out. 


magpi.cc/sausagemummies 
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- RETRO GAMING - 


ee eee 


. RASPBERRY PI 


IE DION 


Retro Gaming with Raspberry Pi shows you how to set up a 
Raspberry Pi to play classic games. Build your own games console or 


full-size arcade cabinet, install emulation software and download classic 
arcade games with our step-by-step guides. Want to make games? Learn 
how to code your own with Python and Pygame Zero. 


= Set up Raspberry Pi for 
retro gaming 


m Emulate classic 
computers and consoles 


= Learn to code your 
own retro-style games 


m Build a console 
handheld, and full-size 
arcade machine 


BUY ONLINE: magpi.ce/store 
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SCREEN: 
2.66” e-ink 
display, 296 = 
152 resolution, 
125 DPI, 

two colour 


DISPLAY 


DRIVER: 

EXT3 board 
with a 90 
degree header 
and 8 megabits 
of flash 
memory 


SOFTWARE: 
Pervasive 
Displays Library 
Suite software 


The pin mapping 
guide is a handy 
way to make 
wiring up easier 
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Pico Kit 


> Pervasive Displays » magpi.cc/epdk > £25/S$30 


A cost-effective and easy way to get into 


using e-ink displays. By Rob Zwetsloot 


small e-ink display to a Raspberry Pi Pico 


T his neat little kit is a great way to adda 
— in fact one is included in the kit. It uses a 


specific extension board to connect to the screen 
and then to Pico using provided jumper wires — this 


does mean that it has a larger footprint than, say, 
the Badger 2040 from Pimoroni, which is used as a 
fun name badge. 

This EPD is aimed at slightly different 
applications and users though. With full access to 
the rest of Pico, many more sensors and inputs can 
be connected to the system, allowing it to be used 


M With full access to the 
rest of Pico, many more 
sensors and inputs can be 
connected to the system @ 


for temperature and air-con control — shown off 
quite nicely in the demo video and code. 


Intense wiring 

Putting it all together out of the box can take a 
little time. Roughly a dozen GPIO pins need to 

be connected to the right spots on Pico, albeit 
made easy thanks to a little pinout card that 
comes with the kit. These jumper wires connect 
to a header which, luckily, slots straight onto the 
extension board, with a ribbon cable connecting to 
the screen. 


It’s all powered off a Raspberry Pi Pico, so you 
won’t need to connect extra power to the screen at 
all - a decent mobile battery should be sufficient 
to power the whole rig. Connect it to a PC and load 
the firmware and demo and, not only will you get 
a look at the aforementioned demo, but a rundown 
of the different functions in the code itself with 


interactive examples — not something we see very 
often, but would like to see more of! 


In its place 

The library for the screen is great and the code is 
fairly simple to understand, although it is in Cas 
it has roots in Arduino, which might cause some 
issues for some people. C seems to run better on 
Pico though than MicroPython, so it was probably 
the right choice to get the most out of it. 

The slightly clunky way it looks when put 
together basically does feel a bit of ashame 
though. Considering how small Pico is, it would 
seem more natural to have something like this 
just mounted onto Pico to save on space. Luckily, 
with the way it’s all connected, you can do some 
sandwiching, but it’s not quite the same. 

Still, it?s a neat and powerful little display that 
can be used in a wide array of settings with a bit of 
creative housing. 


A The whole set up is a little clunky, but it does allow access to all the features of Pico 


REVIEW | Magri Sa 


A The example code 
runs you through 
various functions in 
an interesting way 


Verdict 


Avery powerful 
and well thought 
out piece of kit, 
that feels like it 
could be a bit 
more condensed. 
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Autonomous 
Robotics Platform . 
for Raspberry Pi Pico 


> Kitronik > magpi.cc/kitronikpico >» £41 / S49 


DIMENSIONS: 


PCB length: 
126mm; PCB 
width: 80mm; 


wheel diameter 


This fun robotics board uses Pico to great effect. 


Lucy Hattersley takes it for a spin 


(with tyre): itronik’s Autonomous Robotics Platform slotted in underneath to provide power to the 
Sramm K caught our attention recently thanks motors and Pico. 

SENSORS: to its usage of Raspberry Pi Pico, rather The result is a cute-looking robot that is easy to 
Ultrasonic than the more common Raspberry Pi Model B or assemble, making it perfect for younger robotics 
distance sensor Zero models. makers. It’s incredibly lightweight and moves 
Saat The kit contains a robotics platform chassis with around at a brisk pace. 

following two TT motors pre-mounted. Two large yellow 

sensor board wheels are attached to the side, along with an All aboard 

MOTORS: ultrasonic sensor on the top and a line-following There are a few extras on the robot chassis worth 
o«TT : sensor underneath. Finally, a Pico or Pico W with mentioning. On all four corners sit ZIP LEDs that 


geared motors 


P FourLEDs light 
up the Kitronik 
Autonomous 
Robotics Platform 


a GPIO header soldered in can be mounted in the 
middle of the two motors. Four AA batteries are 
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add bling (and can be useful for feedback). A hole 
in the middle of the board is used to hold a marker 
pen for turtle-like drawing. There is an on/off 
switch to cut the power and a button that responds 
to code (as opposed to the BOOTSEL button on 
Pico W). Finally, there’s an on-board buzzer to 
make audio feedback. 

We found it easy to set up, thanks to the 
included manual. At least to the point where 
the physical assembly was complete. Following 
the build, the manual skims over the API and 
mostly directs you to the Kitronik website 
(kitronik.co.uk/pico-arp-motors) for more detail 
on how to code and control the robot. 

Clone the corresponding GitHub repo 
(magpi.cc/kitpicogit), and you’ll discover code to 
go with all the tutorials and some great example 
programs. Along with tests for all the motors, 
sensors, button, and buzzer, there’s code that 
runs the robot around in circles, line-following 
examples, pen-lifting examples, and a program 
that uses the sensors to control the lights. 
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<q Autonomous Robotics 
Platform is a good- 
looking robot that's 
easy to control 


The GitHub page has documentation on the API, These robots are cheap to buy, easy to set up, 
and the tutorials are comprehensive. sturdy, and fun to program. Hl 


Using Pico instead of Raspberry Pi for the code 
has advantages and disadvantages. Even though 
Pico W is now available, you cannot remote- 
control the robot via a web or smartphone app 
(as you can with many other robots). Perhaps this 
functionality can be implemented down the line. 


<q The PCB board comes 
with two TT motors 
mounted; wheels, 
sensors, and Pico are 
attached to complete 
the build 


M Ideal for a cost-minded 
learning environment @ 


Pico runs code as soon as it’s switched on, 
though, so the robot is functional ina 
code-and-drop way that makes it more 
reliable than Raspberry Pi running 
a full OS. And you’re not faced 
with the usual SSH and wireless 
networking complication 
that troubles many a robot 
setup. You create code on your 
computer and drop it directly 
onto Pico to run. 

We think this is a nice robot build 
that will be lots of fun. It packs a lot of 
features onto a board given its low cost (which 
is better value when you factor in running Pico, 
rather than a full-blown Raspberry Pi computer). 

Autonomous Robotics Platform is ideal 


for a cost-minded learning environment. 9. 


Verdict 


A great little 
robotics learning 
environment that 
is great value 
when you factor 
in the low cost of 
Pico. It's packed 
with features too. 
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Arducam 64MP 
Autofocus Camera 
Module 


SENSOR: 
1/17" stacked 
CMOS image 
sensor, 0.8m 
pixel size 


LENS: 

f/1.8 aperture, 
84° view 
angle, 8cm-~ 
focal range, 
motorised 
focusing 


MAX 
RESOLUTION: 
9152x6944 
stills; 1080p 

30 fps video 


The supplied 15cm 
CSI camera cable is 
used to connect to 


Raspberry Pi; you may 


want to get a longer 
cable or extender kit 


> The Pi Hut > magpi.cc/64mpcamera > £60/ S60 


Zoom in to the fine detail with this 
Super-hi-res camera, By Phil King 


64MP Autofocus Camera Module can 

capture stills with unprecedented detail: 
up to 64 megapixels (9152x6944) on Raspberry 
Pi 4 or CM, (other models are limited to 16MP). 


A s its ‘Hawk-eye’ nickname implies, the 


M Rather than being 
fixed focus, the lens 
iS motorised H 


That’s right up there with the top camera phones. 
It’s not as intuitive to use as a smartphone 
camera, though. 

The 1/1.7-inch sensor is attached to a PCB of 
the same dimensions as a standard Raspberry Pi 
Camera Module. It comes in a neat little case with 
mounting holes and a tripod screw mount on the 
rear. A15cm CSI camera cable is supplied. 

Rather than being fixed focus, the lens is 
motorised; you can hear it clicking in and out. This 
means the camera focus can be adjusted in the 
software — it uses a forked version of the standard 

libcamera library, installed along with 
custom drivers via a few 

Terminal commands. 


Staying in focus 
The autofocus (AF) option is 
a welcome feature, although 

it doesn’t always work quite as 
expected. For instance, it’ll typically 
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A It's the same size 
as a standard 
Camera Module, 
although the lens 
is a little bigger: 
here it's shown 
without its case 


focus on a busy background, so it’s best to shoot 
subjects on a plain backdrop. Alternatively, you 
can use a simple utility to focus manually. Another 
smart option is continuous autofocus, which re- 
triggers AF whenever a change is detected in the 
scene. There’s also a digital zoom (up to 10x) option 
that enables you to move 
the preview around the live 
scene and zoom in and out. 
Indoor shots under 
artificial lighting came 
out rather dark, but this 
can be corrected with 
parameter tweaks such as 
extra exposure. 64MP stills 
also suffered from tiny 
horizontal banding streaks 
in places and tended to be 
a little soft-focus, due to 
lens diffraction, but this 
can be fixed by sharpening 
in an image editor. Hl 


Verdict 


With a single lens, 
it's not as versatile 
as the HQ Camera, 
but the motorised 
focusing is 

neat and it can 
shoot stills at 

an incredibly 

high resolution. 
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10 Amazing: 


Gaming 
Accessories 


Make your Raspberry Pi g lean, mean, 
gaming machine 


e know lots of folks that use a Raspberry Pi to play 
W retro games and homebrew. It’s an easier way to 
hook it up to your TV after all. While you can just 


bodge together a gaming Raspberry Pi, there are many things 
that will help make it just that little bit better. Hl 


4 8BitDo Pro 2 


Retro controller 


With a classic retro design updated with modern conveniences (such 
as Bluetooth), the Pro 2 controller is one of the best ways to experience 
old games. It works on Raspberry Pi, PC, Switch, and more! 


8bitdo.com | £42 / $50 
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4 NESPi 4 Case 


Retro camouflage 


This cheeky case will make your Raspberry Pi seem right 
at home among other consoles - there's also a removable 
cartridge for extra storage. 


magpi.cc/nespi4 | £28 / $34 


> GPi Case 


Handheld gaming 


This familiar case is a genuinely 
great way to have a bit of retro 
gaming in your (big) pocket. It 
even has extra buttons so you can 
play more modern games as well. 


magpi.ce/gpi | £60 / $72 


v Massive arcade button 


For big hits 


This huge button is 100mm across, and comes with an LED as 
well. It's perfect for very specific arcade and gaming builds, 
especially if you need to smack a big button very fast. 


magpi.cc/massivebutton | £8 / $10 


4 Picade X HAT USB-C 


Ultimate arcade board 


Created for the amazing Picade, the X HAT is the absolute perfect accessory 
for turning a Raspberry Pi into an arcade machine. Just build the cabinet, add 
the buttons, and you're good to go. 


magpi.cc/xhat | £16 / $19 


>» Sanwa 8-Way 
Joystick 


Premium movement 


Sanwa parts are the gold standard for 
arcade controllers, and most arcade 
sticks you get can be easily converted 
to use one of these sticks. You 
can even change the gates 
on them - the corners of 

the stick. 


magpi.cc/sanwajoy | £27 / $33 


<Keybow 2040 


Extra hot keys 


Need more keys for your gaming? 
Look no further than the Keybow 
2040; 16 mechanical keys based on 
the same chip as Raspberry Pi Pico. 
You can program it with custom 
commands for gaming macros, or 
stream hot keys. 


magpi.cc/keybow | £50 / $60 
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4 8BitDo Arcade Stick 


Multi-format stick 


Want to get your Street Fighter on like you're at an arcade 
machine? You can't go far wrong with this arcade stick. It can be 
wired and wireless, and has many switches to Let it work in any 
way you wish. 


8bitdo.com | £78 / $90 


>» RGBerry SMA 


Premium RGB HAT 


This HAT is designed to 
connect a Raspberry Pi 
to an old CRT TV or video 
monitor much better than the 
standard analogue video out 
on Raspberry Pi. See those 
beautiful scanlines. 


magpi.cc/rgberry | £30 / $36 


>» Joy Bonnet 


Tiny controller HAT 


This funky add-on for Raspberry Pi 
Zero turns it into a controller that is 
its own console. It’s a bit fiddly, but 
it's also an excellent party piece, 
and can even fit in your pocket. 


magpi.cc/joybonnet | 
f1S/S18 


Retro Gaming with 
Raspberry Pi 2nd Edition [ , 


Have accessories but need to get your 
Raspberry Pi gaming ready? Check out 
this guide on setting up simple, and very 
advanced, retro gaming systems. 
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Learn electronics 
with Raspberry P1 


Resources to help you get started with electronics on Raspberry Pi. By Phil King 


Raspberry Pi Projects 


Raspberry Pi While a Raspberry Pi is powerful 
Foundation enough to be used as a desktop 

PC, what makes it special is its 
Price: 40-pin GPIO (general-purpose 
id input/output) header. As well 
magpi.cc/ 


as being used for connecting 
add-on HAT boards, the GPIO 
makes it possible to hook up 
all sorts of standard electronic 
components, usually on 
a breadboard. 
The Raspberry Pi Foundation’s 
learning resources website is a 
great place to get started with 
building your own circuits and 
writing programs on Raspberry 
Pi to control them. It features 


electronicprojects 


a wide range 

of electronics 
projects, 
filterable by 
topic, hardware 
(including Pico 


| nt oy 


=e 


teen tay Pope 


aes a 
A tenets Pane rowers 


microcontroller), 

software, and 5 

difficulty level. ailtees ee eA i. 
For electronics a = 

newbies, we 

recommend the Physical digital making with Pico 

Computing with Python (magpi.cc/picopath). Other 


tutorial. There are also multi- 
stage paths introducing 

physical computing with Scratch 
(magpi.cc/scratchpath) and 


fun projects to make include a 
laser tripwire, wire loop game, 
burping Jelly Baby, and spinning 
flower wheel. 


Grab a bunch of useful components in a handy kit 


CAMJAM EDUKIT #2 
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MONKMAKES PROJECT BOX 1 

Make the ten projects detailed on instruction 
cards in this kit from Simon Monk which includes 
everything you need to make them: LEDs, a 
thermistor, phototransistor, switches, and more. 
> magpi.cc/projectbox1 


This inexpensive beginner's kit introduces 
you to sensors: a PIR (movement), LDR (light), 
and DS18B20 probe (temperature). Detailed 


worksheets take you step-by-step through 
the projects. 
> magpi.cc/camjamkit2 


WAVESHARE SENSORS KIT 

As used in our Sensory World tutorial series 
(issues 111 to 114), this kit comprises 13 sensors, 
including gas, moisture, and tilt. You'll need an 
ADC (analogue-to-digital converter) chip to read 
analogue signals from some of them. 

> magpi.cc/wavesensors 


i ComJam Edu its. 


CamJam / 
The Pi Hut 


Price: 
£6 /$6 


magpi.cc/camjamkit 


Electronics kits can provide a 
great way to get started, and 
this is one created by CamJam 
(Cambridge Raspberry Jam) is 
ideal for complete newcomers. 
Compatible with any Raspberry 
Pi computer, it contains a 
400-point breadboard, three 
LEDs (red, yellow, and green), 
a push-button, piezo buzzer, 
resistors, and jumper wires. 
More importantly, there’s a 
set of excellent downloadable 
worksheets that feature step- 
by-step instructions, with 
thorough explanations and 
Python code - which makes use 
of the GPIO Zero library. There 


are even Scratch scripts available 
if you prefer that approach. 
Projects include traffic lights and 
some simple games. 

Once you’ve mastered the 
basics with this kit, you may well 
want to move on to the CamJam 
EduKit #2 to play with some 
sensors (see ‘Cool kits’ boxout). 


Simple Electronics 
with GPIO Zero 


Phil King 


Price: 
Free PDF 


magpi.cc/ 
bookgpiozero 


You can download this free 

PDF of this handy Essentials 
guide from The MagPi website. 

It takes you through the basics 
of connecting electronic 
components to Raspberry Pi and 
controlling them, before moving 
on to building some more 
advanced projects. 

n the first few chapters, 
you’ ll learn how to connect 
common electronic components, 
such as LEDs and push-buttons, 
to Raspberry Pi’s GPIO pins 

and control them with Python 
programs. The GPIO Zero Python 
library (magpi.cc/gpiozero) 
makes it a whole lot easier by 
eliminating a lot of boilerplate 
setup code for the GPIO pins. 


While learning about 
electronics and coding, you’ ll 
make fun projects including an 
internet radio, motion-sensing 
alarm, LED thermometer, 
and basic robot. Clear wiring 
diagrams are provided for each 
tutorial, along with all the 
code needed. H 


MagPi 


ELECTRONICS 
GrIoLE RO 


Taspberry Pi 


RESOURCES | Magri 


Recommended reading 
for learning electronics 


THE OFFICIAL RASPBERRY 
P| BEGINNER'S GUIDE 

As well as providing a 
thorough introduction to 

using Raspberry Pi itself, the 
official guide covers numerous 
electronics projects (including 
using the Sense HAT), based 
on both Python and Scratch. 

> magpi.cc/bgbook 


RASPBERRY PI 
COOKBOOK 3RD EDITION 
Simon Monk's 608-page tome 
features several chapters 
dedicated to connecting 
electronics such as LEDs, 
push-buttons, and sensors. An 
updated 4th Edition is due out 
in December of this year. 

> magpi.cc/rpicookbook 


GET STARTED WITH 
MICROPYTHON ON 
RASPBERRY PI PICO 

This official guide for 

Pico covers a range of 
electronics projects for the 
microcontroller, as well as 
using the I2C and SPI protocols 
and controlling NeoPixel strips 
with Pico's Programmable IO. 
> magpi.cc/picobook 
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P The book covers use a 
lot of illustrated elements 
created by Sam 
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Sam 
Alder 


The in-house illustrator and animator for Raspberry Pi 
sets the look for a lot of what you see 


> Name SamAlder | 


> Community role Illustrator | 


ou may have noticed 
Y that we sometimes have 

excellent illustrated 
covers — such as issue 120’s 
robot cover, or even cool 
graphics throughout a feature. 
If you’ve ever thought they 
look similar to some official 
Raspberry Pi art, you’d be right, 
as they’re also by the excellent 
Sam Alder, illustrator and 


> Occupation Illustrator and animator 
> URL samalder.co.uk 


animator for Raspberry Pi. “Or 
as I like to describe it: I draw 
things and sometimes make 
them move - whether they like 
it or not,” clarifies Sam. 


What is your history 

with drawing? 

Growing up, I was always a 
massive doodler, first copying my 
favourite cartoons like Ren and 


Stimpy, Earthworm Jim, and Rocko’s 
Modern Life, and later drawing my 
own comics and weird artwork. 
However, it was never something 
I studied properly at school or 
college. It wasn’t until I got some 
seriously bad A level results, and 
was at a loose end as to what to 
do with my life, that my Mum 
and Step-Dad encouraged me 
to sign up to an art foundation 
course at my local college. It was 
a decision that totally changed 
my life. 
From there, I went on to study 
illustration with animation at 
Manchester School of Art and, 
after graduating, went on to work 
at MTV before starting my own 
animation company, with close 
friend and collaborator Scott 
Lockhart directing music videos 
and TV adverts. 


How did you learn about 
Raspberry Pi? 

I first heard about Raspberry 
Pi back in 2013 whilst sharing 
an office space in Manchester 
with Raspberry Pi veteran, 

Ben Nuttall. He would 
enthusiastically try to explain 
what it was all about, which 
didn’t make a huge amount of 
sense at the time, but it piqued 
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A The animation from Sam that celebrated ten years of Raspberry Pi: magpi.cc/10yearvid 


my interest, so! got in touch 
with my now boss Liz Upton 

to ask if we could make an 
animation to explain the story of 
Raspberry Pi. She kindly agreed 
and put a huge amount of trust 
in our tiny team. Our friendship 
was born, and we went on to 


tons of online resources, books, 
and magazines, including this 
fine publication! 


What other hobbies do 
you have? 

I love making music with 
my brother and have played 


MWe went on to make a further four 
animations over the next 18 months @ 


make a further four animations 
over the next 18 months. 


How did you get your job at 
Raspberry Pi? 
In 2014 I decided to move on 
from our animation company 
and go at it alone. It was around 
that time that I was invited to 
join the, then relatively small, 
team at Raspberry Pi, which 
was an opportunity I couldn’t 
turn down. 

Since then, I’ve made lots 
more animations and illustrated 


guitar, amongst a few other 
instruments, for nearly 25 years. 
I was lucky enough to spend my 
twenties recording, touring, and 
performing with various bands, 
so music is a massive part of my 
ife. Other than that: making 
pies, watching and playing 
cricket (incredibly badly), and 
exploring the Peak District, 
where I live with my partner 
Jane, are how I like to spend 
my time. Gosh, my hell-raising 
days are certainly behind me 
aren’t they! 
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A Our Smart Garden cover was created by Sam, 
based on what we wanted to put in the feature 
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MagP1 


Monday 


Amazing projects direct from our Twitter! 


very Monday we ask the question: have you 


made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 


they’ve made. 


Here’s a selection of some of the awesome 
things we got sent this month — and remember to 
follow along at the hashtag #MagPiMonday! Hl 


Prototyping with cardboard boxes is a 
time-honoured tradition 


RFID music players are a thing we've 
seen in the past, and they're always 
pretty great 


These infinity mirror goggles on this 
hat are ingenious, really making them 
stand out from the crowd 


More folks are making clean train 
departure boards, and this one on an 
e-ink display is great 


We hope the price of that USB 
extension didn't.. sting. We'll see 
ourselves out 


We do love a good Node-RED project 
- using it to light up LEDs is a Dr Lucy 
Rogers classic, and it's great to see it 
done with NeoPixels 


Asmart way to maintain the life of this 
mini OLED display 


BirdNET-Pi is used to identify different 
bird sounds, so this is a very creative 
housing for it 


nstead of hunting for ghosts, Kevin is 
unting for the optimum WiFi channel, 
with a Pico W! 


We could absolutely do with this to-do 
ist some weeks 
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e a jor 


we have reached alpha 0.1 with the cyber deck. we 
need a bigger usb hub though for more peripherals 


ae Szymon Jakubiak 


I'm building a RFID-controlled music player for my 2.5 
years old daughter. Pi Pico is programmed in 
@CircuitPython. It's already in a working state, | 
document it here: github.com/szajakubiak/rf 


m Kevin Just 
Yes, | finally finished mk. 1 of my steampunk hat 
Consists of a pico LiPo from @pimoroni, a battery, a 
neopixel strip combined with 3D printed googles anda 


holder, designed in @tinkercad ve 


| think | planned this 2 years ago, this weekend | was 
finally motivated enough @ 


MéigPi 


ay James Linnegar 
sar nneget 


A custom train departure board for my two closest 
stations :) 


B. Charlie O'Hara 
> @whalecoiner 


Replying tc Mag and @ Raspberry P 


Made my Raspberry Pu home automation server look 
“slightly” too aggressive and scorpion-like with a bendy 
USB extension. 2 


Bart Nijssen 
rs @bwanijsser 


Replying to @TheMagP 


=) HomeMadeGarbage 
% HOmeMadeGarbage 


Replying to ('TheMagh 
| enjoyed LED lighting using Raspberry Pi Zero 2 W with 


node-RED. 
#MagPiMonday 


This weekend | created an outdoor bird house for my 
new #birdNET-Pl 
£B. thinkicarndo = 


@thinklearndo 


Replying to @TheMagP 


Updating my garage door state indicator to use 
inverting images so the OLED display doesn't get 
screen burn in. There is a @Raspberry Pi in there :) 
project files: github.com/thinklearndo/g... 


AxWax (@axwax@fosstodon.org) 


Reptying to @TheMagh 
seas pore I've had a play with my new @Raspberry Pi Pico and 
i @pimoroni's Pico Inky Pack. 
Happy hot #MagPiMonday ! | managed to grab server time, custom images and my 


| made a Wifi Hotspot scanner using a Raspberry Pi 
Pico W, (it's also inside this cool 3d printed 
Ghostbusters case and yes, the arms move based on 
Signal strength). Download the code here: 
github.com/kevinmcaleer/g... 

#ghostbusters #raspberrypi #micropython 


to-do list via @trello's API from my server, using 
buttons to switch. 


Video of it in action: twitter.com/AxWax/status/1 


#MagPiMonday #MicroPython 
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Martin Parker 
2Mt_MartinParker 


Replying to @TheMagP 


Thanks to @kevsmac code last night | got a cctv image 
to show on a @pimoroni display pack using a 
@Raspberry_ Pi #Picow 


© Leo White 


pool temp monitor. 


usable 
twitter.com/LeoWhitesTweet 


#MagPiMonday 


@ Leo white 
Spent at 


Ww 


| was in awe of the #jwst photos last week and wanted 
a desktop viewer for NASA's astronomy picture of the 
day. | used #circuitpython, hoping to port it to a pico 
w soon. The irony of using such a small screen is not 
lost on me @, this is a trigger to look at the big 
version! 


1 


12. 


13. 


14, 


Having a slide show display of 
different JWST and NASA photos is a 
great way to improve your desk 

we think 


Martin was also able to see the photo 
elsewhere a bit more clearly, but this 
is great for glancing at 


If you're in the UK at the moment, 
making sure your paddling pool is 
nice and cool is a must 


This Finger LED thing seems to be a 
game in the making - check out Dr 
Footleg's Twitter feed for the videos, 
they're very cool 


g0 | magpicc | MagPi Monday 


Finished off, and deployed, the hardware for my PicoW 


Software works, but the code isn't very pretty/re- 


———__________ 
bod Dr Footleg - Roboteer 


Replying to Magt 


That Neopixel Flinger LED installation project | posted 
about last week got some new features. Spent ages 
playing with it with my kids. #MagPiMonday 


@ Or Footieg - Roboteer Merfootieg Ju 

Neopixei Flinger update. Added loacs of features this week. Streams colour 
blend as they pass through each other so don't hide one another. They burst into 
glowing ember particles. They slow down anc change colour showing their 
speed. Super fast short red shots split slower ones 
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/, = aspberry Pi projects you can \ 
Crowdfund this! Peete ray Mr 


funded 


Based on RP2040 mm 


\PyROBOTICS 


CodeRover EncroPi 


This ‘sustainable and programmable robot’ is a great robotics platform 

that allows you to build, modify, and program as you wish. It uses a Aneat USB data logger and RTC that allows you to 
‘core’ that you plug into a Raspberry Pi or a microcontroller and hook up encrypt data on it - and it uses an RP2040 that powers 
via jumper cables to the rest of the system. Once that's done you can Raspberry Pi Pico. It even has a little LCD screen on it 
program it with the block-based Code:Bit platform built for the robot. so you can see what time is being kept on the RTC. 


> magpi.cc/CodeRover > magpi.cc/EncroPi 


QELECROW 


CrowPi L - Your Real Raspberry Pi Laptop 


{} 96 i= i) 


40-pin GPIO 96+ Courses HDMI Port 5000mAh Battery 
For Building Projects For Hardware & Programming For Double Monitors Works For Three Hours 


| crv 


Hareware contrss 


aman Planting System 


eae > t Crowtail Modules 
| Neen 7 Sj ae sian a 


www.crowpi.cc 


| www.elecrow.com 


Email: info@elecrow.com CrowPi L Base Shield 
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More mother clocks 


[In reply to a tweet about the Pico railway clock from issue 120 - Ed] My 
old uni had something like this through our building. Someone cut a 
wire somewhere and killed the whole system until it was traced. 

I thought it received a 1Hz ‘clock’ pulse (you see what I did 
there!). The system could send multiple pulses to adjust for summer 
time hours. 


Steve vid Twitter 


That sounds like a bad way to find out about that system - we had other 
people tell us of similar systems, such as factory clocks. Again, it’s wild 
that such seemingly ubiquitous tech has been lost to time, especially as it 
seemed to work pretty well — despite the hazard of being cut. 


A This clock needed a pulse to 
actually tell the time properly, 
provided in this case by Pico 
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Embedded events 


I saw that there was a Raspberry Pi presence 
at Embedded World that I completely missed. 
Are there any other events you’ll be at in the 
near future? 


Amy vic email 


Yes, various teams will be showing up at events 
around the world as places open up more - the next 
one will be Silicon with Adam Savage in California, 
which will be starting the weekend after this issue 
is released (27 and 28 August). Features Ed Rob will 
be there too, sporting a fancy green Luigi’s Mansion 
cosplay, so look out for him! 


A Keep an eye on Raspberry Pi's social media for info 
about when the teams will be at different events 


Contact us! 


> Twitter @TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.com 
forums.raspberrypi.com 


A Wayne Chan's notifier was used to make sure 
people knew how many others were in the office 


Regarding the Entry/Exit Notifier [issue 117 - Ed] 
— Mr Chan can extend his WiFi dongle range by 
attaching the dongle to a USB cable and placing the 
dongle through a hole in a soda, soup, or Pringles 
can about an inch from the bottom of the can. 
Then aim the can in the direction of the nearest 
WiFi access point. I have used this cantenna 
successfully between my and my neighbour’s 
house when I temporarily shared my internet 
connection with him, as his connection was out 
of service and he was under a deadline for his 
business. His house is about 100 yards from mine. 


Buz vid email 


Ah yes, we sometimes forget about some of the 
more interesting range extension hacks for WiFi. 
This one can be useful for anyone - although 
make sure that you have permission, like Buz’s 
neighbour, for anything like this. 


= 


Served for you 


Electronics housings — now 
with displays and keypads 


Electronics housings from = 
Phoenix Contact are now 
available with integrated touch 
displays or displays with 
membrane keypads. You 
configure your customised housing solution and we take 
care of everything else; from printing to mechanical 
processing up to the pre-assembly. 


For additional information call 01952 681700 or visit 


https://phoe.co/ucs-rpi-uk 
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INSPIRING INNOVATIONS 
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LIFTING THE LID ON VIDEO GAMES 


MODDING ~ 


HANDHELDS 


~ NINTENDO'S 
UNUSUAL ORIGINS 


_” PROBLEM SOLVED 
: =, A quide to designing better puzzies 


ol 
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EIGHT GAMES A WEEK 


The Beatles subtie influence on video games 
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CROWPI L 
BASIC KIT 


An amazing laptop body 
for your Raspberry Pi, 
CrowPi L is the lighter 
version of CrowPi2, yet Is 


still just as useful. It has 

a webcam above the 
screen, and provides direct 
access to specific ports on 


( — 


Raspberry Pi. We have one 
kit to give away. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/crowpil 


Terms & Conditions 


Competition opens on 24 August 2022 and closes on 29 September 2022. Prize is offered to participants worldwide aged 13 or over, except employees of Raspberry Pi Ltd, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram, Facebook, Twitter or any other companies used to promote the service. 
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MY € 
IS BRomnuTER 


(How dot fix it?) 


BY BARRY COLLINS 


takes the most common 
computer problems and tells you 
how to fix them. It’s as simple 
as that! If you've ever wondered 
why your laptop won't turn on, 
you can't get a WiFi connection, 
your printer isn't printing, or why 
everything is so slow — well, this 
is your book... 
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THE MAGPI #122 
ON SALE 29 SEP 


Plus! DON'T MISS OUT! 


Build a Magic Mirror magpi.cc/subscribe 


Petoi Bittle: the 
Al dog TWITTER @TheMagPi 


FACEBOOK _ fb.com/MagPiMagazine 


Deep dive witha 
LEGO RC submarine EMAIL magpi@raspberrypi.com 
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Wearing Raspberry P1 


Did you notice that Features 


Ed Rob Zwetsloot |ikes to write about 


wearables and cosplay? There's a good reason for that 


into dressing up. I vividly 

remember being 17 and going to 
every charity shop in town looking fora 
specific type of striped trouser I could 
wear for an Ace Ventura outfit. It 
wasn’t even for a specific or important 
event. It was just fun. 

Fast forward several years, and 
suddenly I’m attending comic cons and 
anime conventions, and seeing a lot of 
people having fun dress up as their 
favourite fictional characters, so I join 
in. The more I participated and learned 
about cosplay, the more I noticed the 
creativity and craft behind it - and the 
impressive electronics people 
were installing. 

As the internet, YouTube tutorials, 
and making in general, has blown up 
over the last decade, so too has the 
complexity of costumes and props. A 
friend of mine has 3D-printed a Buster 
Sword from Final Fantasy VII, complete 
with glowing Materia orbs from the 
game, something you just wouldn’t see 
in the 2000s. 


Ec or a very long time, I’ve been 


Getting stuck in 
Asa maker myself, and writing for The 
MagPi, I have definitely been wanting 
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to make some great and grand things 
for cosplay with Raspberry Pi. My first 
foray was some flashing NeoPixels on 
Raspberry Pi Zero for my friend Freya 
and her Sans (from video game 
Undertale) cosplay. You can find it at 
magpi.cc/neopixeleyes, and it ended 
up working pretty well. 


M |'m basically 
upgrading a Luigi's 
Mansion costume to 
be a bit more of 
g spectacle @ 


Programming NeoPixels has come a 
long way since then, and is far easier on 
Raspberry Pi Pico. However, | did learn 
some limitations. Buttons in Python 
scripts need to be very carefully 
managed to make sure each press is 
registered — something GPIO Zero is 
mostly successful with, but can be 
easier with Pygame due to the way it 
threads stuff. Also, soldering NeoPixels 
correctly can be very tricky if you don’t 


have much soldering experience. 
Despite having done this and helped 
other pals work on their own cosplay 
electronics, I still haven’t got around to 
it myself, despite my previously 
mentioned grand plans. 


Into action 

As you read this, Pll be in my way to the 
Bay Area in California for Silicon with 
Adam Savage. Raspberry Pi has a booth 
there and, as well as showing people 
Raspberry Pi projects on the stand, I'll 
be walking around in a Pico-powered 
cosplay. I’m basically upgrading a 
Luigi’s Mansion costume to be a bit 
more of a spectacle, and I’m really 
ooking forward to showing it off to you 
in the next issue, including a tutorial on 
how to replicate it! 

It’s really cool how making is 
becoming so much more easier and 
accessible to include in your 

other hobbies. H 


Rob Zwetsloot 


Rob had to 3D-print a hoover this month 
for important work-related reasons. He 
refuses to provide more context. 
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HiPi.io 


HIGHPI PRO 


»-——_ The new case from the HiPi.io team _—————- 


® Rapid tool-free assembly and disassembly ® Secure microSD card cover 

@ Large internal volume for HATs ® VESA mount support 

® Compatible with Pi 2/3/4 ® Molding-configurable output ports 
e@ Multiple lid options customizable for volume orders 

® Passive & Active Cooling options @ Printed logo for your branding 


Available at these great Pi stores: 


e = td 
 Pishop.us ry PiShop.ca {°PiShop.mx zpinut Pi-Snop.ch Welectron. 


Contact your favorite Pi store if it’s not listed here 


Manage your servers or 
workstations remotely 


A cost-effective solution for data-centers, 
IT departments or remote machines! 


PiKVM HAT 


for DIY and custom projects Pre-Assembled version 


e Real-time clock with rechargeable super capacitor @ OLED Display e Bootable virtual CD-ROM 
& flash drive ®@ Serial console ® Open-source API & integration ® Open-source software 


Available at the main Raspberry Pi resellers 


cere BW prishopcz Welectron. (lektors¢: rut | 2 


Pi-Suop.ch @zPinut #€ PiShop.us } Pishop.mx 


Reseller suggestions and inquiries: 


wholesale@hipi.io 


